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HOW TO GET 

OVER $2000 WORTH OF NEW 

CAPABILITIES FOR YOUR 

COMM 




OR $599 



The Spartan™ is the Apple™ II + emulator for your Commodore 64™ that will open 

up a whole new world of hardware and software for youl Imagine adding these 
features to your Commodore 64™ for the Spartan™ price of $599: □ Apple™ II + 
hardware and software capabilities □ 64K RAM expansion □ four 
software selectable Commodore 64™ cartridge slots □ non-dedicated 8-bit 
parallel port □ standard audio cassette deck capabilities for your C-64™. 
The suggested retail value of comparable products offering only these 
capabilities is over $2200.00* — but the Spartan™ gives you much, much 
morel By building on your investment in your Commodore 64™ — an 
excellent introductory computer — you create a whole new system 
with both C-64™ and Apple™ 11+ capabilities. There is a whole other 
world out therel The huge selection of Apple™ II + hardware and 
software is now yours to explore! Call toll free for the Spartan™ 

dealer nearest you. ' 




FOR INFORMATION WRITE: 

MIMIC SYSTEMS INC. 
1112 FORT ST., FL. 6L 
VICTORIA, B.C. 
CANADA V8V 4V2 



•All prices quoted ore In U.S. hinds, height and taxes not Included. Value ol components equivalent 
to Itie Spartan" system are quoted hom Apple" - II + CPU and Apple" II + single disk drive 1°!J 
list prices, and hom cunent suggested list prices and component specifications ol othet 
peripheral manufacturers. Commodore 64" and Commodore logo are trademarks ot 
Commodore Electronics ltd- ond'or Commodote Business Machines. Inc. Apple" lit Is a 
trademark ot Apple Computer Inc. Spartan" Is a trademark ol Mimic Systems Inc. and hos 
no association with Commodore Electronics or Apple Computer Inc. The sparton" Is 
manufactured by Mimic Systems Inc. under license granted by ATG Electronics Inc. ol 

Victoria. BC. Canada. 
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BUG and CBUG 

We have received word from Norman 
Deltzke, president of the Chicago B-128 
Users' Group (CBUG), that the national 
B-128 User Group (BUG) is no longer in 
operation, and that its director, Marl in 
Schwanke, is no longer attempting to 
operate the group or publish the newslet- 
ter that he had founded. Because of this, 
we must now advise you to not send away 
membership fees to the address we gave 
for BUG in our December 'Bulletin 
Board' section — there is apparently no 
longer anything to send away for. 

CBUG, in contrast, is thriving, and 
looks like an important source of infor- 
mation and support for B-128 users. The 
club now claims about 2000 members in 
the US, Canada, Australia, New Zealand, 
England, Sweden, Germany, Italy and 
other countries, and a heavy publishing 
schedule. Activities include local 
meetings in the Chicago area, and sup- 
port via telephone and newsletter for 
members elsewhere. CBUG's mailing ad- 
dress is: 

CBUG 

c/o Norman Deltzke 
4102 N. Odell 
Norridge, Illinois 60634 

Membership fees are $10.00 (US) a year. 

This month 

This month's feature on the Commodore 
128, and particularly its CP/M mode, is 
largely the work of Adam Herst and 
Miklos Garamszeghy, two Toronto-area 
authors who see outstanding potential in 
this most versatile of 8-bit machines. 
Look for more articles on the 128 from 
Adam and Miklos in issues to come. 

While we're talking about the C-128, 
owners of the 1571 disk drive will want 
to know of the following DOS bug, which 
we just saw reported in the latest copy 
if Info magazine. Look there for details 
but, briefly, the problem arises when you 
attempt to validate, in 1541 mode, a disk 
that was formatted double-sided in 1571 
mode. After this operation, the 1571 
mode will no longer recognize that your 
disk is double -sided, and unless you rec- 
tify the misunderstanding right away, 
you will in the course of subsequently sav- 
ing and loading files become the proud 
owner of an irretrievably corrupted disk. 



The fix, if you find yourself in this situa- 
tion, is to use a direct access command 
to write $80 (decimal 128) to byte 4 of 
track 18, sector 0. Info provides a short 
program to do this job for those who can't 
manage it on their own. 

Blank disks 

Due to a hardware glitch in one of the 
4040 disk drives, a number of blank disks 
were sent to members. The problem has 
since been corrected, but anyone who 



received one of these disks can get a free 
replacement by mailing or telephoning 
their name, address, and membership 
number to the TPUG office. 

Amiga feedback problem 

TPUG is looking for member feedback on 
the establishment of an Amiga chapter. 
Any person interested in becoming a 
coordinator for this chapter should con- 
tact Bruce Hampson, Genera! Manager, 
at the TPUG Office. 

The editors □ 



The state of TPUG 



Much has happened at TPUG in the past three months. Perhaps most impor- 
tant has been the installation of a new computer system. This IBM -compatible 
system allows us much faster access to our .18,000 membership files and records, 
and allows us to keep better control over our orders. With the new system, we 
need less staff to give our members much better service with fewer problems. 

Our finances are in great shape, and we are on a sound foundation with some 
innovative programs coming up. We have purchased some new office equipment 
and systems and are embarking on a new membership drive. Membership is grow- 
ing again, and more and more associate clubs are joining us. We have also 
straightened out most of the complaints and problems. 

One problem we are still having is with our software library. Major changes 
are being worked on in that area, including the acquisition of a high-speed disk 
duplicator, and a reworking of the disk cataloguing system. The Disk of the Month 
subscription series was even more successful than we had hoped, which led, 
ironically, to more problems. These are now almost completely solved. 

One of our new staff members, Sally Murciano, is working almost exclusively 
on associate clubs. With more than 65 clubs and 3000 of our members included 
in this category, we have decided to spend even more time and resources on 
this section. If you are a member of a users' group not yet affiliated with us 
directly, write to Sally for more details. We can offer you a considerable sav- 
ings on membership as well as some other great benefits. 

We have had a number of problems lately with cheques and correspondence 
from our members. Please remember to include you membership number on both 
your letter and cheque. This is especially important for people who hand -write 
their letters instead of typing them. Sometimes signatures are hard to decipher, 
and without you membership number we have no way of getting back to you. 

We would also appreciate it if you would not post-date cheques. These are very 
confusing and cause us great problems. If you must post-date, then please make 
sure that they are well marked (perhaps in a different colour) to show us. Some 
days we might process 500 cheques, and often these get through the system 
before the bank catches them. 

We also appreciate the number of letters we have received expressing your 
support for us. We have just come through some difficult times with flying col- 
ours, and your understanding and patience have been most appreciated. Now 
that we have most things settled, we look forward to serving you even better. 

Bruce Hampson 

TPUG General Manager u 
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press your views on Commodore 
computing by writing to: 

Line Noise 

TPUG Magazine 

101 Duncan Mill Road, Suite G7 

Don Mills, Ontario MSB 1Z3 

Canada 



Amiga skepticism 

Your articles on the Amiga seemed par- 
ticularly directed to people who like to 
simply fool around with computers: as 
one of those very people, I'd like to tell 
you about my first two weeks of Amiga 
ownership — its joy and its frustration. 
The sound and colour are both substan- 
tially better than anything else I've 
played with and, in particular, the 
tremendous voice capability is worth 
hours of exploring its possibilities. 
Beyond that, my initial reactions have 
been negative. Most of my frustration 
results from not having any documenta- 
tion on the machine — something that 
will, I suppose, be cured in time. Here I 
live in the shadow of the Company itself, 
know some of the employees, and get con- 
stant assurances that the documentation 
is available. The hard fact is that I can't 
get it, and have spent much of the past 
two weeks unsuccessfully trying to con- 
nect my printer, program the function 
keys, transfer files from one disk to 
another, or get into the fabled high- 
resolution mode — the kind of thing that 
was readily done on the C-64 because it 
came with a Programmer's Reference 
Guide. The absence of an equivalent 
volume makes the Amiga unready for 
marketing to programming buffs, and the 
total absence of software makes it 
unready for other users. 

A big disappointment is the editor built 
into ABasiC. It is 1982 state-of-the-art, 
lacking the friendliness and power of 
even our present-day editors, let alone 
the bold new future promised by the 
advertising hype. Another disappoint- 
ment is the slowness with which it starts 
up. Kick-starting is the way it was done 
in 1975 — there are better ways available 



Much is made of the graphics capabili- 
ty of the Amiga. Its ABasiC commands 
have some new scope but they are not as 
powerful as I expected, not at all revolu- 
tionary, and not nearly so good as those 
of the Macintosh. Mostly, new names 
have been given to old graphics com- 
mands, and the clumsiness of standard 
plotting routines has been retained. I was 
hoping for, and will probably get in the 
future, a substantially easier system for 
manipulating the screen display. 

My advice to TPUG readers is, Don't 
Throw Away Your C-64! The Company 
may make more money changing models 
all the time, but hackers lose by it. We 
will get more return on our effort by stay- 
ing with one model, continuing to build 
up our library of software and a ware- 
house of hardware attachments to fit that 
model. I strongly feel we users should do 
whatever is necessary to encourage Com- 
modore to continue supporting the C-64, 
and do what we can to counter the trend 
among merchandisers to dump it in 
favour of these new models. The advan- 
tages claimed for the new models simply 
do not justify abandoning our C-64 soft- 
ware and hardware. 

Deep in every hobbyist there always 
lurks a strong urge to get something 
newer and better, an urge that usually 
gets expressed as updating to some 
newer model. Loss of compatability is a 
terrible price to pay — let me suggest that . 
an alternative way to satisfy this craving 
is to go in for peripherals. Add on voice 
control and voice generation. Add on a 
hard disk drive. Keep your C-64 as the 
core of your system and connect up a 
video camera so it can see as well as hear 
and talk. If you don't already have a 1520 
plotter, get one — it's marvellous (and 
also on the endangered list, like the C-64 
itself). 

Let's mount a campaign to promote 
enhancements for the C-64 rather than 
replacements. Save the C-64! 

Walter Stauber 
Springfield, Pennsylvania 

You're right — Amiga documentation is 
hard to come by. But let's not be too 
nostalgic for the good old days of the Com- 
modore 64 — the Programmer's 
Reference Guide did not come with the 
machine, but had to be purchased 



separately, just like the documentation for 
the Amiga. Nor was it available 
simultaneously with the 64 's release. 

Another point on the same subject: the 
64's Reference Guide was good, par- 
ticularly by the Commodore standards of 
yesteryear, but it wasn't perfect. How 
much of what you know about the 64 came 
from magazine articles published over the 
last three or four years, how much from 
Jim Butterfield's memory maps, how 
much from other books? It will admitted- 
ly take a long time before we'll see that 
quantity of information for the Amiga, 
but this is true of any new machine. And 
though they are still in short supply, Com- 
modore's progamming manuals for the 
Amiga are both comprehensive and detail- 
ed. With such a complex machine, that 
means a lot of documentation — and som-e 
of it is even comprehensible. 

ABasiC is a dead language now, of 
course, which no one is lamenting. 
Microsoft's AmigaBasic is vastly 
superior, and has a full screen editor too. 
Sure, you have to load it in from disk in- 
stead of having it pop up instantly when 
you switch on your machine, but there are 
some small compensations. For instance, 
try writing a 1200-baud terminal pro- 
gram in BASIC on the Commodore 64. 
You can do it in half a screen in 
AmigaBasic. How about a graphics 
package, with lines, circles, boxes and 
area fills, and with a screen resolution 
equal to the 64 's hi-res mode, but with 16 
colours instead of two? I've seen three or 
four such programs already on the 
Amiga, and they all have two things in 
common: they're fast, and they're short. 

And here's something you didn't men- 
tion — multitasking. Until you've used the 
Amiga for a while, it's difficult to ap- 
preciate just how convenient the multi- 
tasking can be. The, ability to skip back 
and forth between programs without hav- 
ing to shut any of them down is something 
you'll eventually take for granted — and. 
you'll feel strangled when you have to go 
back to a single-task machine. The 
graphics and the sound are nice — spec- 
tacular even, by the standards of most 
computers — but I think it's the multitask- 
ing that will have the profoundest effect 
on hackers and users alike. 

Throw away your Commodore 64 ? No, 
absolutely not. There are times when the 
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straightforwardness of the 64 's user inter- 
face is just what you want and need — and 
of course, you've got all that software. But 
don't give up on the Amiga, either. It isn't 
perfect but, in a lot of ways, it's the best 
there is. 

Nick Sullivan 

On copy protection 

I have been a Commodore computer user 
and a member of TPUG for several years 
now, and I have enjoyed both the com- 
puters and my memberships in TPUG. I 
have been quite disturbed by the past 
several issues of TPUG Magazine, and in 
particular by the November 1985 
editorial. 

The trend that has disturbed me is 
TPUG's apparent support of copy protec- 
tion. While I am certainly not in favour 
of software theft (a term I prefer to 
piracy, which has certain romantic over- 
tones), I am equally opposed to copy pro- 
tection of software. 

In particular, the last issue's editorial 
equated programs designed to copy or 
"break' protected disks with 'piracy tools'. 
This implies, I suppose, that owners of 
these programs are in fact pirates, and 
magazines that advertise them are 
advocating piracy. 

While it is true that these programs 
could be used for such illegal purposes, 
to call them 'piracy tools' is absurd. It is 
the same as calling people who own 
modems and terminal software 'computer 
criminals', since modems and terminal 
software are indeed necessary tools for 
anyone desiring to break into a system . 
Most owners of such equipment have pro- 
bably never even tried to do such a thing, 
just as most owners of 'copy busting' pro- 
grams are probably not pirates. 

While I am not familiar with Canadian 
law, the copyright laws in the US give the 
original purchaser of a program the legal 
right to an archival copy. Copy protection 
attempts to deny this right to the legal 
purchasers, and copy -busting programs 
attempt to give it back. Consider some- 
one who makes his living as a writer, and 
uses the computer as a tool of the trade . 
Only a fool would use a program that 
could not be backed up — deadlines could 
be missed, et cetera. 

As personal computers grow more 
powerful — and Commodore computers, 
in particular, have grown enormously in 
power with the introduction of the C-128 
and the Amiga — copy protection 
becomes increasingly less desirable. 
Many owners of Amigas and 128's will 
undoubtedly wish to purchase hard disks. 
I do not envy these individuals their 
future attempts to move copy-protected 



software over to a hard disk. Amiga 
owners may wish to run concurrently two 
or three programs. Copy protection often 
involves replacing the DOS code with 
code from the protected programs — 
what is going to happen when the BCD 
word processor tries to change the code 
already installed by ACME spreadsheet? 
Several scenarios spring to mind, involv- 
ing things from smoke to destroyed disks, 
lost data, and grey hairs. 

The current trend is clearly anti-copy 
protection. A large number of software 
houses have announced that they have 
dropped copy protection on all of their 
products, due to the hardship forced upon 
their users. Publishers of software such 
as Borland (Turbo Pascal) have proven 
that copy protection is not necessary to 
a successful software business. Other 
publishers (such as Sirius Software) have 
demonstrated that copy protection does 
not ensure success by copy protecting 
their software and entering Chapter 11, 

I would submit to you that, given the 
choice, most people would choose a non- 
protected program over a protected one. 
I would also suggest that there is strong 
evidence that the tide is turning against 
protection , both by legitimate users and 
legitimate software publishers. I would 
further suggest that without copy protec- 
tion, 'copy -busting' programs would not 
exist. It seems to me the course of action 
is clear — if you really wish to stamp out 
these piracy tools, help your users, and 
remain in the forefront of the computer 
revolution (which TPUG always has), you 
should refuse to advertise any protected 
software, and advertise instead only the 
copy -busting programs. 

Consider — if all magazines had this 
policy, in order to bring their products to 
the attention of the public, software 
houses would have to drop the protection 
on their products. This, in turn, would 
cause the Copy Buster programmers to 
go out of business, or turn to other pro- 
ducts: what good is a copy -busting pro- 
gram when there is nothing to bust? Peo- 
ple would be able to move programs to 
their hard disks without worry, Amiga 
owners would be able to multitask to their 
heart's content, and the software 
publishers would whistle all the way to 
the bank. 
Scott Ballantyne 
New York, New York 
I -agree that the trend among software 
publishers is away from copy protection, 
particularly on software directed at the 
new machines, and I too am glad that it 
is so. Nor do I personally oppose the mak- 
ing of archival backups of protected soft- 
ware, or utilities that make this possible. 



But copy protection, with all its faults, is 
not a conspiracy on the part of software 
publishers to make life difficult for com- 
puterists, however common that side-effect 
may be. And it is a response to piracy 
(though perhaps, ultimately, a misguided 
and self-defeating one), not the cause. 

Early, unprotected, commercial pro- 
grams suffered widespread illegal 
duplication. It was not unnatural for the 
software manufacturers to seek methods 
of ensuring that the users of their products 
were also paying customers. Copy- 
protection is one of those methods; another 
one is the use of copious documentation, 
since information is far less convenient- 
ly copied when it comes in printed rather 
than magnetically-encoded form. The lat- 
ter method is becoming more popular as 
the software itself becomes more complex: 
it is significant that most of those com- 
panies that do not use copy-protection are 
those whose products require heavy doc- 
umentation; whereas games manufac- 
turers, for instance, have been slower to 
abandon what for them is their only 
means of defence. It may be that it will one 
day be possible to abandon protection, 
along with such other inconveniences as 
locks on doors, border guards, and access 
codes for banking machines; meanwhile, 
we have to accept that we belong to a soci- 
ety that views all these impediments to 
civilized living as necessary and normal. 

Let us set aside the question of legal 
rights, for surely there are conflicting 
rights here — ours to copy, the publishers' 
to protect — and agree that there is a case 
for copy-protection, whether or not it is 
finally convincing. How do the publishers 
ofdeprotection software fit into the scheme 
of things, and how do they present their 
products? Very often with an overt appeal 
to the romantic image of piracy you decry. 
Have you seen the full-page colour ads for 
a product called The Shadow? It is not 
directed at the freelance writer who needs 
a security backup of a word processor. 

What amazes me about the magazine 
ads for deprotection utilities is not their 
existence, but their quantity. The fact that 
this rather arcane specialty is so prolific 
and so vigorous can't be unrelated to the 
huge amount of illegally-cloned software 
available in every schoolhouse and every 
corporate office-building. It may be that, 
by refusing ads for these utilities, TPUG 
has abstained from the battle against 
copy-protection; it may also be that 
magazines that accept such ads are put- 
ting the ability to pirate software within 
reach of the mass of consumers, rather 
than just the ingenious few. 

Nick Sullivan 
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with Malcolm O'Brien 



If you have a question for The 
Answer Desk, write to us at: 

Answer Desk 

TPUG Magazine 

101. Duncan Mill Road. Suite G7 
Don Mills, Ontario MSB 1ZS 



C-64 Meets Waterloo 

Is Waterloo BASIC available for the C-64 
and, if so, where can I get it? 

Joseph Srdarev 
Etobicoke, ON 

Yes, Joseph, it is. Waterloo Structured 
BASIC is in wide use on PETs, and is 
part of the curriculum in many schools 
and community colleges. It is favoured by 
educators, since its structured program- 
ming statements encourage the writing 
of more readable programs that are much 
easier to maintain (and to grade!). 
Subroutines take the form of named pro- 
cedures that can be CALLed by name. It 
also includes commands such as AUTO. 
DELETE and RENUMBER, which are 
very helpful editing tools. You can order 
it from: 

WATCOM Products 
415 Phillip Street 
Waterloo, ON 
N2L 3X2 
(519) 886-3700 

The software is on cartridge, and the 
package includes a comprehensive text- 
book containing both a primer and a 
reference manual. WATCOM also offers 
seminars on BASIC and WATCOM 
Pascal. Call or write for pricing 
information. 

Fade-in diagnosis 

Sometimes when I switch on my C-64 
system, the blue Commodore screen 
doesn't appear on my monitor — it's 
definitely on, but the screen is a blank 
dark grey. After several unsuccessful at- 
tempts, there will come a time when the 
regular blue Commodore screen actually 
fades on after a few moments. Sometimes 
it doesn't, and I just let my computer 'cool 
down' for a few hours. After that time, it 
switches on fine. I feel the problem is the 



computer, not the mo7iitor. No one I have 
talked to can tell me what's wrong (if 
anything). Your help would be 
appreciated. 

M. Kanas 

Mount Albert, Ontario 

Intermittent problems are the hardest to 
diagnose and to fix. My guess is that your 
problem is a faulty power supply. Try 
another power supply, if you have access 
to one, and see what happens. If that pro- 
duces the same result, you'll have to in- 
vestigate further. You can isolate the 
faulty component in your system if you 
proceed step by step. 

First, disconnect your 64 from the 
monitor and hook it up to your TV, us- 
ing the cable and RF modulator that 
came with the 64. If you still have the pro- 
blem, it is definitely the computer itself, 
and you should have the VIC II chip 
checked. If the 64 works fine with the TV, 
reconnect the monitor, but this time try 
the inputs on the front of the monitor in- 
stead of the back (or vice versa if you've 
been using the front ones). If you still 
have the problem, try a different video 
cable. The last link in the chain is the 
monitor itself. Try a different monitor, 
or try using your monitor with a VCR. 
Somewhere in the course of all this, the 
offending item will be revealed. Although 
this process of replacing components and 
trying different things can be tedious and 
time-consuming, it is almost always effec- 
tive for ferreting out 'gremlins'. 
Back in the August/September issue, I 
gave the name and address of Cynthia 
Wood (HHB S2d AADCOM CMR 2122, 
APO, New York 091 75) who has offered to 
be a resource for the Answer Desk. Cyn- 
thia's specialty is Superbase. She has 
since fielded several Superbase enquiries, 
which are reproduced here along with her 
answers. Thanks a lot, Cynthia! 

Railroad management 

I have been using Superbase 64 for a 
variety of address lists, and find it very 
valuable. However, I would like to use it 
to run my model railroad pass list on, but 
it would appear that you can't have" a 
combination 'Key list' and 'Number list'. 
Or can you? If you can , how would it be 
arranged? I would like to have the pass 
numbers (001 on up) as the first item, 
followed by name, address and the like. 
I would also like to take the pass list and 



use it to put the names and so on in 
alphabetical order. Is this possible? 

S. Richard Knotts 
Wheaton, Maryland 

If I understand your question correctly, 
Superbase will readily handle your pro- 
blem. You may choose either the Number 
field (001 and so on) or the Name field to 
be your Key field. This will depend oji the 
order in which you. want the records to ap- 
pear when you are working with the file 
on-screen (as opposed to outpuUing to 
pointer or creating reports) — mainly 
entering and editing your file. If the 
Number field is the Key field then your 
records will be in numerical order. If 
your Name field is the Key field, they will 
be in alphabetical order. The Key field 
does not have to be the first field of the 
record. 

If you choose the number field to be your 
Key field, follow this procedure for 
creating an alphabetical 'key list 'for out- 
put and report uses (see section 10 in the 
Reference section of the User's Manual): 

1) From Menu 2, press 14 to choose the 
Sort option 

2) Type: all on [name] to "halphlist" 

Put the name of your Name field in the 
brackets and call the list (in quotes) 
anything you xvant. Start it with an h if 
you want to be able to view the list with 
the Help option, and end it with the word 
list to prevent accidentally writing over 
other files by choosing an identical name. 
This is a good habit. I use -base, -list. - 
export ajid similar file-type suffixes to 
prevent accidental erasures. Files within 
a database are the only things that I don't 
give an identifier. 

3) Press return. Superbase will create an 
alphabetical list of your files. Viewing it 
with the Help option will display the 
numbers of each record. To see the records 
in the keylist, use the Output option: 

la) From Menu 1, press 14 

2a) Type: from "halphlist" (number] 

[name] [address] [state] 

The brackets enclose your field names. 
These may be omitted, in which case all 
fields will be listed, or any number of 
fields may be chosen for viewing. Also, the 
word down (as in down from 
"halphlist") may be inserted to display 
the fields in a column instead of across. 
Down and across remain in effect until 
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the other is specified. The same goes for 
display and print, which select the screen 
and the printer respectively. 

So) Press return and watch your records 
turn up alphabetically on the screen 
4a) Output to printer by using print 
from. . . in step 2a above. 

There is another interesting feature of the- 
Sort option that allows you to create a list 
in descending numerical or reverse 
alphabetical order. Simply insert a D- in 
the sort command (step 2 above becomes 
all D- on. . .). Your sorts can also be 
layered (alphabetical first names within 
alphabetical last names, for example) by 
specifying more than one field in the sort 
command. 

Output hangup 

I have two questions: 

1) When I wish to print out a list or 
report to my printer, I'll get a few lines 
of the data and then the printer stops. 
The disk will continue to spin, but nothing 
is output to the printer. I get out of it by 
disconnecting the printer. I end with an 
'I/O 5' error. I am using a Cardco +G in- 
terface, with transparent mode on and 
auto LF off. I use 'dev 4, pdef 5'. Can you 
give me any hints as to what my problem 
may be and possible measures to correct 
it? 

2. When loading a database, the screen 
shows the database catalog of files. When 
I wish to scratch a file, I enter the Main- 
tain menu, then use the other option to 
scratch the filename from the disk (which 
does happen). My problem is that the 
filename remains in the Database 
Catalog, even though the file itself is 
gone. How do I remove it? 

Matthew Brown 
Chilli waek, BC 

1) I tried to duplicate the problem and it 
refused to be a problem. I have a Gemini 
10X printer and the same interface. I nor- 
mally have the transparent mode off (in- 
terface dip switch seven on) but I turned 
it on (SW7 off) to match your set-up. Keep- 
ing auto LF off (my usual mode) I chang- 
ed the pdef to 5 (I normally use 0), and still 
came up with no printing problems. You 
did not say which printer you have. I 
would suggest you try turning the 
transparent mode off and using pdefO. If 
that doesn't work, I don't think I can help. 
By the way, the 'I/O 5' is a Kernal message 
meaning 'Device Not Present', which real- 
ly tells you only what you already know: 
that there has been a catastrophic 
breakdown in communications between 
the computer and the printer. 

2) To delete a file you must first delete all 



records (with d on the Select menu, con- 
firming each deleted record with y). Then 
from the main menu, type select delete 
to delete the file. The filename should now 
no longer be in the catalog, and you can 
delete the file from the disk. 

Sort with duplicate keys 

I have an address list with an added 
numerical field, and I would like to have 
a printed list in numerical order. When 
I attempted to sort on the numeric field, 
I ran into a problem that I had experienc- 
ed before when using the sort option: 
some numbers are printing out of order. 
When the print routine accesses the 
record, it does so by the key, and in this 
case looks for the first Smith that it has 
available. Because there are several 
Smiths, the one it grabs may not have the 
proper number. Do you know of any other 
way around this problem? 

Bob Adler 

Kenil worth, New Jersey 

Here is a program that wilt enable you to 
print your pass list numerically. It will 
probably be a very slow process but it 
works. The manual leads me to believe 
that there is another way: Section 4.1.4, 
page R-20, says to devise a program us- 
ing Select Next, but I don't think it's 
possible to Select Next when outputting. 
We would have to be able to stop the out- 
put process to check each record to make 
sure it is, indeed, the Smith we want (us- 
ing if/then), and- selecting the next record 
if it isn't. 

10 rem sort on number field 

with duplicate keys 
30 rem for screen display a 
dd "81, n" before first f 
ield in line 230 
100 ask 84,4"Enter total nu 

tnber of records ";r 
110 print 830"PASS LIST" 81 

"No." 86 "Name" 835 "Ad 

dress" 860 "City" 
190 n=0:n1*="" 
200 n=n+1 :n1$-str$(n) : if n< 

10 then n$="00"+right$t 

n1$,1] 
210 if n>9 then n$="0"+righ 

t$(n1$,2) 
215 if n>99 then n$=right$( 

n1$,3] 
220 select match where [ num 

ber] is n$ 
230 print [number] G [first 

names] & [ lastname] 830 

& [address] 855 [town] 
240 select last 



250 if n=r then display:men 

u 
300 goto 200 

Lines 200 and 210 set up a variable based 
on the number n, which is increased by 
one each time through. Ifn is less than 10, 
it must be preceded by two Os; if greater 
than 9, by only one. The rlght$ function 
eliminates the space reserved for the sign 
of a number variable so that n$ won't be 
"00 1 ". Line 240 insures that each search 
will begin at the beginning of the file. □ 
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Getting Started With CP/M 



by Adam Herst 

Copyright • 1986 Adam Herst 

In their advertising, Commodore com- 
pares the C-128's 'higher intelligence' 
with the fallen fruits of the Apple or- 
chard. Unfortunately, Commodore forgot 
to include in their comparisons one of the 
C-128's most powerful features, a Z80 
microprocessor and its accompanying 
operating system, CP/M. This feature 
makes the C-128 one of the lowest-priced 
entries into the ranks of dedicated 
business computers, and opens up a pro- 
gramming environment never before 
seriously implemented on Commodore 
computers. 

In CP/M mode, you have access to 
CP/M Plus, the latest version of CP/M: 
the same operating system that controls 
countless other computers from a varie- 
ty of manufacturers. Previous versions of 
CP/M are compatible (with restrictions) 
with CP/M Plus and a large base of pro- 
grams exists: from languages to utilities, 
databases to wordprocessors, available 
both commercially and from public do- 
main libraries. Using these programs re- 
quires little if any knowledge of CP/M 
other than how to get your system set up. 
This article will cover the basics of set- 
ting up CP/M on the C-128, and will tell 
you how to extract a forty page Help 
manual from your CP/M systems disk. 

What is CP/M? You car> think of CP/M 
as an extremely sophisticated and power- 
ful DOS wedge. Its primary purpose is to 
manipulate, and maintain status informa- 
tion about, the physical devices that make 
up your system, the disks the system is 
operating on, and the files that are on 
those disks. A bonus is the inclusion of 
all the tools necessary for a complete 
assembly language programming 
environment. 

Physical devices 

Most CP/M systems consist of a computer 
running CP/M and at least one disk drive. 
CP/M on the C-128 can support multiple 
disk drives (almost a necessity), and up 
to two printers. If you've used more than 
one disk drive on a CBM machine before, 
you are probably aware that they can sup- 
port up to four disk drives assigned 
device numbers 8 through 11. CP/M mode 
mimics this setup and supports up to four 



physical drives assigned device letters A 
through D. To set up a multiple-drive 
system, you must change drive device 
numbers through hardware, or through 
software from C-128 mode, before booting 
the CP/M system. After the system has 
booted, drive 8 becomes drive A, drive 9 
becomes drive B, and so on. 

Two drives are recommended since 
CP/M involves a lot of disk and file shuf- 
fling. If you do not have two or more 
drives, don't worry — CP/M on the C-128 
is configured to provide a virtual drive 
available to everyone regardless of the 
number of physical drives attached to the 
system. This drive is designated as drive 
E . The use of drive E won't save you the 
disk switching, but it will make copying 
files and running multidisk programs 
possible . 

Booting the system 

Unlike the BASIC operating system in 
128 mode, which resides in ROM, the 
CP/M operating system must be loaded 
into memory from disk. There are two 
ways to boot the CP/M system on the 
C-128. 

If you are using a single drive or multi- 
ple drives assigned different drive 
numbers through hardware, you can boot 
the system by inserting the systems disk 
in drive 8 with the computer off and the 
drive on. Once the disk is inserted, turn 
on the computer and CP/M will autoboot. 

If you are using multiple drives that 
need their drive numbers changed 
through software, first change the drive 
numbers from 128 mode. After this has 
been done, put your systems disk in drive 
8 and type BOOT. CP/M will boot and 
take control of the system. If you try to 
boot CP/M by using the reset button, you 
will only succeed in resetting the drives. 

In both cases, a successful boot is in- 
dicated by the CP/M ready prompt, A > , 
and a flashing cursor. 

As mentioned, CP/M's primary purpose 
is to provide status information about 
your system. One way it does this is 
through the prompt. The A> prompt 
tells you that your primary drive is drive 
A. This is the drive that will be accessed 
unless you tell the system otherwise. If 
you are using a multiple drive system, you 
can change the primary drive designation 
by typing the new primary drive tetter 
followed by a colon at the prompt. To 



change the primary drive to drive B, type 
B: < RETURN > at the prompt. 

CP/M expects you to type in commands 
at the prompt. Commands are files that 
reside on disk with the file type .COM, 
To see a directory of the disk in your 
primary drive, type DIR at the prompt. 

40 or 80 columns? 

When CP/M boots on the C-128, the 
system expects an 80 column screen as* 
the output device. Consequently, infor- 
mation is formatted for 80 columns . If 
you are using a 40 column screen, the 
C-128 allows you to scroll across 80 col- 
umns using the grey cursor keys. If you 
haven't tried this yet, do so. You'll 
understand why I say that, though it 
works, it is very annoying. 

Unfortunately, most programs for 
CP/M expect an 80 column screen and 
format screen information accordingly, so 
you will have to use the screen scroll func- 
tion keys. However, if you are using on- 
ly the CP/M commands and utilities, you 
can tell the system to format output for 
a 40 column screen. 

To do this, insert the utilities disk con- 
taining the device.com file in the primary 
drive, and at the prompt type device con- 
sole [page columns = 40] < RETURN > . 
Until you change it again all subsequent 
CP/M output will be formatted for a 40 
column screen. 

Copying disks 

The first thing I do when I get new disks 
is make backups. (The reason for this is 
another story that I'm only just starting 
to be able to laugh about). There is a 
reason other than security to make copies 
of the systems disks provided with the 
C-128. To ensure compatibility with 1541 
disk drives, the two sides of the 
distributed disks are recorded separate- 
ly on a single-sided disk drive. To access 
the second side you must flip the disk 
over! If you are using a 1571 you will 
want to copy these two sides onto a 
double-sided disk so that disk flipping is 
not necessary. 

Unlike other implementations of CP/M, 
a copy of the systems disk can be made 
using the PIP utility. Copysys is not im- 
plemented on the C-128. Files with the 
.SYS extension are treated in the same 
Continued overleaf. . . 



8 TPUG Magazine 



A hard copy of Help 



by M. Garamszeghy 

Copyright 1985 Miklos Garamszeghy 

CP/M Plus on the C-128 has a com- 
prehensive on-line Help facility that 
allows you to call up data on the various 
features of CP/M, and the syntax of 
most of its commands. Sounds con- 
venient, doesn't it? 

Well, it is — except when you need 
it most: when you're stuck in the 
middle, of a CP/M command or utility 
and you forget the command syntax. 
One solution is to exit the program or 
abort the command {assuming that you 
haven't forgotten how) and call up the 
Help routine. A better solution which 
1 have found is to consult a hard copy 
of the Help file listing. The major por- 
tion of the Help.HLP file is an ASCII 
file (remember that CP/M works in true 
ASCII, not PETSCII) containing the 
text for the on-screen displays. 

When printed out on paper, the 83R 
byte Help file is over 40 pages of single- 
spaced text. That is a formidable 
amount of documentation for an on-line 
Help file. The file contains some very 
useful data, not found in the C-128 
users' guide, about the various CP/M 
commands and utility programs. This 
makes it a very handy reference tool 
for novice and experienced CP/M pro- 
grammers alike. 

There are several ways to create a 
hard copy of the Help.HLP file. 
Perhaps the easiest, though least 
elegant, method is to use the CP/M PIP 
command. When the CP/M prompt 
(A>) is displayed on the screen, type 
in pip lst: = help.hlp < RETURN >. 

Some garbage will be printed on the 
printer. After several pages have been 
printed, the main text body of the file 
will start to print. If you don't mind a 
few pages of garbage first, then this 
will produce an acceptable printout of 
the Help.HLP file. The garbage con- 
sists of an electronic table of contents 
for the main body of the Help file, 

If you are using a non-Commodore- 
compatible printer through an inter- 
face such as the CARDCO/?, the inter- 
face should be set for transparent mode 
for a standard ASCII print out. In ad- 



dition,.. the printer can be. set to skip 
over the perforations on fanfold paper, 
if this feature is implemented on your 
printer, which produces a nicely for- 
matted output. A Commodore or com- 
patible printer should be set for upper 
case/Sower case mode. However, 
because the Help file is in standard 
ASCII, upper-case characters will 
appear as iower-case, and vice versa. 
This is a minor inconvenience only. 

If you have a 1571 disk drive, the 
hard copy can beobtained in a slightly 
more elegant fashion. Although it is not 
documented in the C-128 System Guide 
or even in the on-line Help file, the 
CP/M Plus Help command has two 
very important options: Extract and 
Create. These options allow you to con- 
vert the Help.HLP file into a standard 
ASCII text file, and then back into the 
Help.HLP file, respectively. To use 
these options, you must have a disk 
with at least 172K bytes of space on it 
(83K for Help.HLP, 7K for 
Help.COM, and 82K for the Help.DAT 
file created by the process). Unfor- 
tunately, this exceeds the 168K of 
usable space on a single-sided C-128. 
CP/M disk. 

The procedure is as follows. Format 
a disk as a double-sided CP/M disk on 
a 1571 drive. Next, copy the 
Help.COM and Help.HLP files from 
the system disk to the new disk with 
the command pip e: = a:help.* 

< RETURN > (for a single drive copy); 
orpipb: = a:help.* < RETURN > (for 
a dual drive copy). 

After the files have been copied, put 
the new double-sided disk in the default 
drive, and type help [extract] 

< RETURN >. Extract can be abbre- 
viated to E. The drive will go on for 
several minutes and the message 'Ex- 
tracting data' will be displayed. The 
process creates a file named Help.DAT. 
This is a standard ASCIItext file con- 
taining only the text part of the 
Help.HLP file. The file can then be 
printed with the command: pip 
1st: = help. dat < RETURN >. Of 
greater interest, though, is the fact 
that the file can also be edited with any 
ASCII text editor, such as WordStar 
(in non -document mode) or the CP/M 



utility. Ed.COM. You can revise the ex- 
isting material and even add some new 
stuff of your own! 

If you do add new data, each entry 
must be preceded by a header line in 
the following format: ///nheading 
name, where n is the Help level from 
1 to 9, and the heading name is the en- 
try name for the Help index. The three 
slashes must begin in the leftmost col- 
umn. A Help level of one indicates a 
major topic, while 2 to 9 are used for 
subtopics. The new material should be 
arranged in alphabetical order by 
primary heading and subtopics. It can 
be inserted between existing topics if 
the alphabetical ordering so dictates. 
An example of a set of : new entries 
would be: 

///INew Topic 

Put text here. 

///2Any Subtopic 

More text. 

///SSubsubtopie 

More text. 

///2BSubtopic 

Text for second subtopic. 

///I Second new topic 

More text. 

. . . and so on . 

The text content can be anything that 
can be printed on the screen. To get a 
feel for the structure of the topic en- 
tries, it is best to examine a few of 
them with a text editor. 

Once the file has been edited and any 
new records added, it is reassembled 
into the Help.HLP file with the com- 
mand: help [create] <RETURN>, 
Create can be abbreviated to C. 

By using the Extract and Create op- 
tions for the Help command you can 
customize and update your Help file, 
and even add entries pertaining to your 
favourite programs. In addition, there 
is no law that says your Help file must 
contain data on CP/M commands. You 
can easily create a custom Help.HLP 
file containing names and addresses, or 
even recipes, which can be readily 
searched by a command such as: help 
John doe or help fudge brownies. This 
is in effect a free database program 
built into CP/M on the C-128! D 
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way as other files. Before making any 
copies, you must first format the destina- 
tion disks. To do this, insert your utilities 
disk with the format.com file on it into 
the primary drive, and at the prompt type 
format < RETURN > . This will load and 
initiate the format command. Follow the 
prompts to format as many disks as you 
like. 

When you've returned to the systems 
prompt, reinsert your systems disk with 
the pip.com file on it and at the prompt 
type: pip < RETURN >. This will load 
pip, the built in file manipulator, into 
memory, initiate execution and return 
with the pip prompt (* ). You now have 
to tell pip from which disk to copy, the 
files to be copied, and the disk to copy 
them to. 

If you are using a single drive system, 
you will have to copy files from the 
primary drive (which I will assume to be 
A) to the virtual drive E. At the prompt 
type e: = a: * . * < RETURN > . CP/M will 
prompt you when it is time to shuffle 
disks. 

If you have more than one drive then 
you will be copying from the primary 
drive to another drive ( which I will 
assume to be drive B). At the prompt type 
b:=a:*.* < RETURN >. 

Since we want to copy the whole disk 
we've used the wildcard * . * , which will 
match every File and cause it to be copied. 
The first asterisk matches the filename, 
while the second asterisk matches the file 
type. As in Commodore DOS, the ? can 
be used to match a single letter. After the 
disk is copied you will be returned to the 
* prompt. Copy the rest of your disks in 
the same manner. If you're using a 1571, 
remember that two single-sided disks can 
fit onto one double-sided disk. 

If you're curious about what you've 
been doing, one adequate source of infor- 
mation is the systems guide provided with 
the C-128 computer. A better source is 
also provided with the C-128 in a less ob- 
vious form. Built into the CP/M Plus 
operating system is a help command and 
extensive Help files. This information can 
be accessed by inserting the sytems disk 
with the help.com and help, hip files on 
it into your primary drive and typing help 
at the prompt. Follow the prompts to 
retrieve the information you desire. 

While more comprehensive than the 
C-128 manual, using online Help files can 
be inconvenient. If you are in the middle 
of executing a program and discover that 
you need some relevant information, you 
must abort the program, shuffle your 
disks and then call up the necessary Help 



file. Wouldn't it be nice if you could have 
all of this information available whenever 
you needed it, online or off? Guess what? 
Built into CP/M are provisions for prin- 
ting the Help files into a forty page Help 
manual! For complete instructions, see 
Mike Garamszeghy's sidebar accompany- 
ing this article. 

Where to get software 

A large number of commercial CP/M pro- 
grams are available to fill practically 
every need. Many of these packages are 
'vanilla' programs, designed to run on a 
variety of CP/M computers. If you are 
buying prepackaged CP/M programs, 
there are a couple of rules to remember: 

• Make sure the program disk contains 
an install file to configure the program 
to suit your system. 

• MP/M (multiple terminal CP/M) and 
CP/M-86 (CP/M for 16-bit computers) will 
not run under CP/M Plus. 

Alternative sources for CP/M programs 
are the various users' groups and public 
domain libraries. CP/M hackers have 
refined many of these programs to com- 
mercial quality over CP/M's ten-year 
history. They can usually be obtained for 
nominal membership or downloading 
fees. The rules for using commercial pro- 
grams apply here as well. 

The original version of CP/M shipped 
with the C-128 did not include support for 
the RS232 port. Consequently, it was im- 
possible to use a modem from within 
CP/M mode. Downloading CP/M files 
meant translating files downloaded in 128 
or 64 mode. Commodore has since re- 
leased an upgrade to the BIOS that of- 
fers a number of useful enhancements, in- 
cluding full support of the RS232 port. 

As well as a 128-mode library, TPUG's 
C-128 chapter has formed a CP/M mode 
library. Programs are distributed on 
single-sided disks recorded using CBM's 
GCR technique. With the permission of 
Commodore Canada, the files necessary 
to upgrade the BIOS are being 
distributed on the CP/M library's first 
disk, (Z)AA. 

As with other Chapter libraries, the 
C-128 library will only be as good as you 
make it. Please donate any public domain 
programs you may have found or written. 

D 

Adam Herst, in addition to being the co- 
coordinator for the C-128 chapter, is the 
TPUG CP/M librarian. He will continue 
to explore all aspects of CP/M on the C-128 
both at the chapter meetings and in future 
articles. 



Marketplace 



COMPUTER RENTALS 

We buy, trade, sell and repair 
Commodore computers. 



1541 alignment 


S 29.00 


Box of 10 disks 


S 14.95 


4040 or 8050 Drive 


$995.00 


2031 Drive 


$375.00 


Superpet 


$995.00 


Green Monitor 


$ 95.00 


Education software 


$ 3,00 
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COMPUTER RENTALS 

17 Cedarbank Crescent 

Don Mills, Ontario M3B 3A3 

Tel: (416) 446-1035 



T1 General 

(Ontario) 

Income Tax 

Templates 

for the C-64 



Includes schedules 1 to 10 

Available for $19.95 plus 

O.S.T. from 

R Link, Box 87, Beaverton, 

Ontario L0K1A0 

Specify one of 

Calc Result™, Muftiplan™, 

or Better Working™. 



Commodore Repairs 

C-64 Computer $69 95 
1541 Disk Drive $69 95 

Total price includes pick-up 
and delivery. Dealer dis- 
counts available. 

VOYAGEUR 

Box 730 Almonte. Ontario 
KOA IA0 

Tel. 613-256-2597 



Autobooting on the C-128 



by M. Garamszeghy 

Copyright ° 1986 M. Garamszeghy 

The C-128 has the ability to automatic- 
ally load and run either a machine 
language or BASIC program from disk 
at power-up or when the reset button is 
pressed. In this process, known as 'auto- 
booting', the computer loads the contents 
of track 1, sector from the disk into 
memory at address 2186 in bank (part 
of the BASIC stack area) and checks to 
see if that sector begins with a certain 
sequence of bytes. If the byte pattern is 
found, the machine language instructions 
in the remainder of the sector are ex- 
ecuted. This feature works with both the 
1571 and 1541 disk drives, as well as with 
most other compatible Commodore and 
non-Commodore drives. 

The required byte sequence consists of 
the three character string "CBM", 
followed by four zero bytes. This can be 
followed by an optional message (up to 
sixteen characters) to be displayed dur- 
ing boot-up. The message is followed by 
two more zero bytes. This sequence is 
followed by some machine language in- 
structions and a BASIC command string 
consisting of either RUN<filename> or 
BOOT<fiIename> for BASIC or 
machine language programs, respective- 
ly. The final byte is another zero. The 
machine language instructions are: 

Idx ^address low 
ldy ^address high 
jmp $aeaS 

' Address low' and 'address high' are the 
low and high bytes of the beginning of the 
RUN or BOOT string that follows. This 
address may change depending on the 
length of the boot message string. The 
JMP instruction transfers execution to a 
routine in the BASIC ROM. 

The program below, Autoboot Maker, 
allows you to write the required byte pat- 
tern to make a boot disk. One word of 
caution , however. Since the program uses 
the random block-write method to write 
the boot sector, the boot disk should not 
be subjected to the DOS Validate or 
BASIC 7.0 COLLECT commands. Either 
of these commands may cause the boot 
sector to be overwritten, and will in any 
case cause it to become deallocated. 
Autoboot Maker will warn you if it finds 
track 1 , sector already allocated. In that 



case, you can either overwrite the ex- 
isting sector or try another disk. If the 
disk already has a boot sector written, the 
old data will be replaced by the new. In 
any event, it is perhaps better to write 
a boot sector on a new disk immediately 
after formatting it. This ensures that the 
sector does not have any valid data on it. 
Interestingly, the BASIC command 
string used in the boot sector is not 
limited to BOOT< filename > or RUN- 
<filename>, but can be any valid im- 
mediate mode BASIC command. By 
changing lines 70 and 80 of the program 
to: 

70 bo$-bo$+" directory"* 
chr$(0) 

for instance, you could have an automatic 
display of the disk directory on boot-up. 
Other useful applications include 
DLOADing a program (without running 
it); BLOADing a machine language utili- 
ty, sprite data, function key definitions 
or a custom title screen; or perhaps mere- 
ly changing the screen colours with a cou- 
ple of COLOR commands. The only ap- 
parent restriction on the command string 
is that its total length must be less than 
one BASIC line (up to 160 characters) and 
must contain only one logical line (that is, 
no CHR$(13)s). All statements must be 
immediate mode (INPUT and GET are not 
allowed). 

Of course, most of the above applications 
(except for the DLOAD) can be performed 
by a RUN < filename > type command 
string. However, while these programs 
are easily accessible to prying eyes from 
the disk directory , a person needs a disk 
sector editor to view or change the con- 
tents of a custom boot sector command 
string. 

10 bo$="cbm":cB$=chr$(B) :fo 

ri=1to4:bo$=bo$+c8$:next 
:color8,7: color4,7:prin 
t" " 

28 print"boot message" : inpu 
t" max 16 chars" ;me$:me$ 
=left$(me$, 16) :sa=2831+ 
lenf me$) 

30 input" boot file name";b 
f$:input" [b]asic or [m] 
ach. lang.";ft$:print" " 

40 dclose :print" boot mess 
age: "me$: print" boot fi 



le name: "bf$; : ifft$="m 
"thenprint" mach. lang. 
":elseprint" basic": 
50 input" ok [y/n] ";o$:ifo 

$<>"y"then10 
60 bo$=bo$+me$+cB$+cB$+chr$ 
C 162} +chr$( 25Sandsa) +chr 
$C 168) +chr$[ sa/256) +chr$ 
[ 76) +chr$( 1 65) +chr$( 175) 
70 ifft$="m"thenbo$=bo$+"bo 

ot" :elsebo$=bo$+"run" 
80 bo$=bo$+chr$(34)+bf$+chr 
${0) :open15,6, 1S:apen8,6 
, 8 , " i" : if dsthendc lose : ga 
tollB 
98 print#1S,"u1:";8;0;1;0:p 
rint#15,"b-a:";B;1;B:if 
ds=65then120 
108 print#15,"b-p:";B;B:pri 
nt08,bo$;:print#15,"u2: 
";8;0; 1 ;0:dclose: ifde 
thenl 10:elseend 
118 print" disk error >> "; 

ds$:goto48 
120 print" boot sector air 
eady in use": input" ov 
er-write [y/n]";owf: if 
ow$=*y "thenl 88 :else48 



FREE SHOPPING BY MODEM 

SATELLITE ELECTRONIC 
SHOPPING MALL 

Take advantage of Ihis tarst FREE electronic shop- 
ping mall. Available to all computer and modem 
users. 

Now you can shop lor insurance, cars, computers, 
books, software, travel tickets & holidays, and 
much more in the comlort ol your own home or ol- 
lice. The electronic stores are open 24 hours a day, 
7 days a week lor your convenience. 

Stores In the Mall Modem 

Bayside Computerized 831-0666 

Insurance Shopping Data Base 
Compu-Car 831-6678 

Shop for new GM, Chrysler, and Ford cars 
Computer Shoppe 831-6907 

Order computer hardware 
Alpha Books 4 Software 831-6908 

Order computer books and software 

Electronic Travel Agency Coming soon 

Book flights, holidays & hotels 

And More Openings Coming 

Check with any ol the shops lor more mall intormation. 

LINK UP WITH YOUR 
SATELLITE DEALER TODAY!! 
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A scrounger's guide to CP/M 



How to beg, borrow and otherwise 
obtain CP/M software for the C-128 



by M. Garamszeghy 

Copyright ® 1 986 M. Garamszeghy 

CP/M opens a whole new world of adven- 
ture for both the casual and serious Com- 
modore computer user. Although it is one 
of the oldest microcomputer operating 
systems (born circa 1975), and has been 
implemented to a limited degree on other 
Commodore machines, it is totally new to 
most owners of the C-128. Over the 
years, CP/M has become almost the de 
facto standard for 8-bit computer 
operating systems, especially business- 
oriented systems. 

There are literally thousands of CP/M 
computer programs on the market and in 
public domain libraries. Many of these 
programs will, in theory, run on the 
C-128. The problem lies in the fact that 
practically none of the software is 
available in Commodore GCR disk for- 
mat, the recording technique used ex- 
clusively by the 1541. 

You may not realize it, but there was 
some CP/M software included with the 
C-128 computer. If your machine came 
with only one CP/M disk (marked 'System 
Disk') like mine did, turn it over! Even 
if you have one of the new double-sided 
1571 drives, you must still turn the disk 
over to access the second side. The flip 
side (marked 'User Utilities Disk') con- 
tains most of the utilities referred to in 
the manual - Ed.COM, Date.COM, Sub- 
mit. COM and other CP/M favourites. 
(Because I generally do not use 'flippies', 
it took me three months before I noticed 
this, quite by accident.) 

Another valuable source of CP/M soft- 
ware and technical information is the 
mail-away card packed in the C-128 
System Guide manual. If you are serious 
about CP/M programming, the two-inch 
thick manual and the three disks (one flip- 
py and one single-sided) that you get for 
your 20 bucks (30 Canadian) are well 
worth the money. The manual contains 
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very detailed instructions on the CP/M 
resident commands, as well as the tran- 
sient utilities. For the machine language 
programmers and hardware hackers, it 
also contains detailed information on the 
various BIOS and BDOS function calls, 
complete with examples of how to use 
them. The disks contain a whole slew of 
machine language-oriented utilities, such 
as the two main CP/M assemblers 
Mac.COM and RMac.COM, and the 
dissassembler Sid.COM. Also included 
are demonstration assembly language 
programs and library files. 

. . . Commercial CP/M 
software is available in 
many different disk for- 
mats. Unfortunately, 
Commodore GCR is 
usually not one of 
them . . . 

The next major source of CP/M soft- 
ware is the public domain libraries. 
(Although their stocks are usually limited, 
there are a few public domain libraries 
that cater to Commodore CP/M users at 
modest cost. One that comes to mind is 
Poseidon Electronics, 103 Waverlv Place, 
New York, New York, 10011.) Most of 
these libraries operate bulletin boards 
(remote CP/M — RCP/Ms, in the popular 
lingo), where the software can be upload- 
ed or downloaded for a nominal charge. 
This, of course, assumes that you have a 
modem and a suitable terminal program 
for your 128 (usually a form of X-Modem, 
otherwise known as MODEM7, which is 
the standard CP/M program file transfer 
protocol). 

Commercial CP/M software is available 
in many different disk formats. Unfor- 
tunately, Commodore GCR is usually not 
one of them. The problem of disk format 



incompatibility was reduced with the in- 
troduction of the 1571 disk drive, which 
can read most of the popular CP/M disk 
formats (except Apple CP/M, which is 
perhaps the most common). However, 
that is no help to people like myself, who 
do not have a 1571 drive. Despite this, I 
now have a fairly extensive library of 
CP/M software (including such favourites 
as WordStar, CalcStar, dBase II, 
MB ASIC and Fortran-80) on 1541 for- 
mat disks, thanks to a bit of electronic 
jiggery-pokery. The trick lies in first ob- 
taining the software in a format readable 
by a 1571 drive, then using the genius of 
the 1571 to translate for you. The catch 
is, of course, that you must have tem- 
porary access to a 1571. 1 used one in a 
local computer store, the manager of 
which didn't seem to mind me playing 
with his demo equipment for a couple of 
hours. 

The 1571 is truly a remarkable 
machine. Using the CP/M PIP.COM utili- 
ty ('PIP* stands for Peripheral Inter- 
change Program — I never could figure 
out why they just didn't call it Copy), you 
can copy from a foreign disk format to 
1541 GCR format with a single drive. The 
procedure is as follows. First format 
some blank disks as C-128 single-sided 
disks with the CP/M Format command. 
These are equivalent to 1541 format 
CP/M disks. Next, with the CP/M system 
disk (the boot disk that comes with the 
computer) in the drive, type PIP 
< RETURN >. When PIP is loaded and 
ready to run, it will respond with the 
prompt *. 

Now you can copy the program files. 
Remove the system disk and replace it 
with the foreign disk containing the files 
you wish to copy. To copy an entire disk, 
enter the command 

e: = a: ".*< RETURN >. To copy a single 
file, use e: = a:<filename.ext >< 
RETURN >, where filename.ext is the 
filename and extension of the file you 



wish to copy. The 1571 will buzz and click 
for a few moments. A reverse video 
message will appear at the bottom of the 
screen listing the suspected format of the 
foreign disk. The message TBM-SS', for 
example, indicates a single-sided IBM 
CP/M-86 format disk. If you know this to 
be the correct format, press RETURN. Do 
not use the CTRL-RETURN key combina- 
tion to lock in the disk format. 

The 1571 will log drive a: as that for- 
mat. If you know for sure that the pro- 
posed format is incorrect, or if you wish 
to see what other choices you have for 
that disk format (some disk formats are 
similar enough that the 1571 cannot 
automatically distinguish between them), 
use the cursor-left and cursor-right keys 
to scroll through the choices. When you 
find the correct one, press RETURN. 
Single-drive copying is then performed by 
following the prompts on the screen for 
removing and inserting the disks at the 
correct times. Press RETURN to restarc 
the copying each time you insert a disk. 
Disk a: is the foreign source disk, and disk 
e: is the C-128 destination disk. It may 
be a good idea to cover the write-protect 
notch on the source disk to prevent 
disaster from striking if you accidental- 
ly mix up the two disks. Drive e: is a 
'phantom', or virtual, disk drive. It does 
not really exist except in the memory of 
the C-128. This concept is essential for 
single-drive copying. 

If you are using two drives, a: and b: 
(either two 1571s — one set to device 
number 8, and the other set to device 9 
via the DIP switches at the back — or a 
1571 set to device 8 and a 1541 set to 
device 9 via the hardware method), you 
can use the command 

b: = a:*.*<RETURN> or 

b: = a: <filename.ext >< RETURN > , 
where the source disk is in drive a: and 
the destination disk is in drive b:. With 
two drives it is not necessary to swap 
disks during the copying process. A 
similar procedure to that described above 
can also be used for copying files from 
C-128 format to a foreign format, and 
between two foreign formats. 

Once the programs have been transfer- 
red to 1541 format, the easiest way to 
back up your software with a 1541 is to 
start up the C-128 in C-64 mode, and use 
one of the many '3 minute' disk copying 
programs available. This, of course, can 
only be used to copy whole disks. You will 
still need the CP/M PIP command to copy 
individual files. 

If you own a 1571 drive, you can pur- 
chase CP/M software in a wide variety of 
popular disk formats. Of course, these 



will be 5 1/4-inch disks. Much CP/M soft- 
ware, including all of the stuff I started 
with, is available on 8-inch disks. (This 
was how all CP/M software was originally 
used.) How, do you ask, did I get these 
8-inch disks into the 1571 drive to copy 
them? The answer is, obviously, I didn't. 
What I did use was a bit of creative 
hacking. 

My software started life on 8-inch 
CP/M disks used on an ancient (circa 
1981!) TRS-80 Model II computer. The 
programs were transferred via a null 
modem cable to a nearby IBM-PC. (For 
the benefit of techies, I used an X-Modem 
program on the TRS, and CrossTalk in 
X-Modem mode on the PC.) The result 
was a set of CP/M files on 5 1/4-inch 
disks, but in PC-DOS format. Despite all 
its talents, the 1571 cannot decode the 
directory data on PC-DOS disks. (CP/M 
directories are of the same structure in 
any disk format and are very simple to 
decipher). To overcome this, I wrote a 
short hybrid machine language-BASIC 
program for the IBM-PC which converts 
PC-DOS files into the CP/M-86 files that 
can be read by the 1571, thus readying 
them for translation into 1541 format. 
The point to this paragraph is not to show 
a roundabout method to get CP/M soft- 
ware for the C-128, but to emphasize that 
CP/M software from one machine and 
disk format can be easily made (relative- 
ly speaking) to run with a totally different 
machine and disk format. 

With some CP/M software, it is 
necessary to 'configure' the program for 
the specific hardware features of your 
system. Popular CP/M software, such as 
WordStar, often comes with an installa- 
tion program allowing you to set up the 
software for running on a wide variety 
of computer systems. Unfortunately, I 
very much doubt that you will find a con- 
figuration program that has the C-128 in 
its list of supported systems. This may 
change as the C-128 gains popularity. 
However, the engineers at Commodore 
had the good sense to make the C-128 
emulate one of the more popular com- 
puter terminals, the Lear Siegler 
ADM -31. (It also emulates the less 
sophisticated ADM-3A.)The LS-ADM-31 
is found on nearly all CP/M configuration 
program menus. Thus, almost all CP/M 
software can be configured to run on the 
C-128. 

Incidentally, this article was written 
with WordStar configured for the 
ADM-31, using a 1541 disk drive. Not the 
fastest word processor combination 
around (for obvious reasons), but still 
quite manageable. d 



Missing Letter Puzzle 

1) Insert your COMAL diBk in drive*. 

2) Type LOAD "C64 COMAL*", 8 

3) Type RUN (starts COMAL) 

4) Type AUTO (turn on auto line#'s) 

5) Enter the program lines shown below 

(COMAL indents lines for you) 

6) Hit RETURN key twice when done 

7) Type RUN 

Pr-gr-mm-r's P-r-d-u- P-ck-g- 
Programmer's Par? 

0010 dim text$ of 39, disk$ of 2 

0020 open file 2,"miBsing.dat",read 

0030 disk*:=status$; count:=0 

0040 if diak*="00" then 

0050 count 'text 

0060 else 

0070 close // no data file found 

0080 create'text 

0090 endif 

0100 play'game 

0110 // 

0120 proc count'text 

0130 while not eof(2) do 

0140 read file 2: textt 

0150 count:+l 

0160 endwhile 

0170 close 

0180 endproc count'text 

0190 // 

0200 proc create'text 

0210 open file 2,"missing.dat" ( write 

0220 print "input text (or blank):" 

0230 repeat 

0240 input textS 

0250 if text$>"" then 

0260 write file 2: textj 

0270 count:+l 

0280 endif 

0290 until text*="" 

0300 close 

0310 endproc create'text 

0320 // 

0330 proc play'game 

0340 open file 2, "misBing.dat", read 

0350 for x:=l to rnd(l,count) do 

0360 read file 2: text$ 

0370 end for x 

0380 close 

0390 for letter:=l to len(textj) do 

0400 if text$(letter) in "aeiou" then 

0410 print "-", 

0420 else 

0430 print text $ (letter), 

0440 endif 

0450 endfor letter 

0460 print 

0470 for letter:=l to len(textt) do 

0480 while key$otext$(letter) do 

0490 print "?"+chr$(l57), //left 

0500 endwhile 

0510 print textl(letter), 

0520 endfor letter 

0530 endproc play'game 

* If you don't have COMAL yet, order a 
Programmer's Paradise Package -$19.95. 
It includes the complete COMAL system 
plus over 400 pages of information. Add 
$5 more to get our 20 interactive lesson 
Tutorial Disk. Add $2 shipping. Visa/MC 
or US funds check accepted. Send to: 

COMAL Users Group USA 

6041 Monona Drive, Room 109 
Madison, WI 53716 
phone 608-222-4432 
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C-128 book flawed but useful 



Commodore 128 

Internals 

by K. Gerits, 

J. Schieb and F. Thrun 

from Abacus Software 



Review by Jim Butterfield 

Copyright *> 1986 Jim Butterfield. Permis- 
sion to reprint is hereby granted, provid- 
ed this notice is included in the reprinted 
material. 

This book contains a great deal of infor- 
mation about the Commodore 128 that is 
not yet generally available. It contains a 
rich fund of technical data on the 128, 
together with comments on the C-64 
mode as it fits together with the machine. 
The information isn't complete (perhaps 
it's too early to hope for that yet). There 
are some inaccuracies. And the material 
is heavily technical . . . it's not suitable for 
a beginning level programmer or user. 
Considerable machine language ex- 
perience is called for in working through 
the book. 

Hacker's heaven 

The book has a heavy hard- 
ware/hacker/machine language content. 
You know that if a chip is mentioned, 
you'll get detailed pinout diagrams and 
register descriptions. If an interface is 
described, you will get a picture of the 
edge connector and possibly information 
on voltage levels. Good for service depart- 
ments, but probably overkill for the pro- 
grammer and user who would never think 
of diving in with a soldering iron. This 
kind of detail is featured prominently, 
and takes up a fair amount of space in the 
book; the reader who doesn't need it will 
end up browsing through to areas of more 
interest. 

The book also spends a good deal of 
time and space on 'known' hardware and 
techniques. Even though the 40-column 
chip has only two new registers (at 
$D02F and $D030), the whole chip is 



discussed at length in Chapter 2. You'll 
get the story on sprites, split screens, 
character sets, screen colours, high- 
resolution, multicolour and extended col- 
our modes. None of this is new, and in 
this area the book cautions, "all of the 
following programs must be entered in 
the 64 mode" . The two new registers are 
not discussed at this point. You'll find 
similar detailed discussions of 'known' 
chips in Chapters 3 and 4, which deal with 
the CIAs and with the SID chip. 

If you're moving up from the Com- 
modore 64, you might feel that you know 
all this stuff, and that you'd rather see 
the book focus specifically on new 
material. On the other hand, you might 
be pleased to see the book attempting to 
cover the entire range of the architecture. 
Chapters 5 and 6 do break considerable 
new ground. The VDC — the Visual 
Display Chip that drives the 80-column 
display — is outlined in detail and several 
of its idiosyncrasies are discussed. And 
the MMU — the Memory Management 
Unit that controls the architecture of the 
computer — is also outlined. Until the 
Commodore Programmer's Reference 
Guide becomes available, this book may 
be one of the best sources of information 
on these two chips. 

Chapter 7 is titled 'Assembly Language 
Programming', It largely discusses the 
Kernal routines, and how to create a 
'boot' or autostart disk. It is the last 'nar- 
rative' chapter of the book. . . and yet the 
book is less than half finished. 

Chapter 8 is the bulkiest part of the 
book. It contains a detailed disassembly 
of Kernal ROM, with each line com- 
mented. I miss the BASIC ROMs, but 
they are 32K in size, and including them 
would have more than doubled the size of 
this book, which is already massive. To 
read such ROM listings, a user needs to 
have some expertise. The pieces of code 
fit together jigsaw fashion, and to under- 
stand one part the reader will need to 
know how other parts interrelate. The 
disassembly code contains some 'Euro- 
pean' ROM progamming that is not found 
in North American models of the Com- 
modore 128. 

The verdict 

The book is relatively good, but is not 
completely free of errors. Part of the 

disassembly on page 387 is wrongly per- 



formed (instructions at F934, F936 and 
F94B are not shown correctly). The 
memory configuration table on page 145 
has copied a typographical error from 
some early Commodore documentation; 
configuration 13 should reference RAM 
0, not RAM 1 as shown. 

This book is not an easy read. There's 
a lot of good information here, but you'll 
have to dig for it. There's an index, but 
it's of limited use. The writing style is 
often stuffy ("Those who think it would 
be boring to take a close look at this chip 
would be deceiving themselves.") 

But there's good stuff in here. The book 
is out early, and contains a great deal of 
data not easily available from other 
sources. For the serious student — and 
you'd better be a serious student — it's 
a goldmine of good information. 

Commodore 128 Internals, Abacus Soft- 
ware, PO Box 7211, Grand Rapids, 
Michigan 1,9510. □ 



NOW GET TRUE DESCENDERS 
FOR 801, 1525. 803, GP-100, 
HUSH 80 & SIMILAR PRINTERS 

From the Descender ROM People 

peopt 

SAMPLE 
ACTUAL SIZE 
FEATURING ! 



ARTS 



• True descenders 

• A pleasing alternative 

• Uniform character formation 

• No change In graphic capability 

• No change In software compatibility 

• No change in printer operation 
■ North American standard font 

• Complete Instructions 

• Easy installation 

• No soldering 

$39.95 Cdn $29.95 U.S. 

Onr. R«,denti odd 77, Prov Solei T QI 
Chequ*, Moiv«| Order. V its or MoilerCord 



QS"j 



WILANTA ARTS 

6943 Barrlsdale Dr. 

Mississauga Oni. 
L5N 2HS 

1-416-858-9298 

Get a Witanta Descender ROM Today 

and make your old nightmare 
Just a font memory of yesterday ! 
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ATTENTION 

ALL COMMODORE 64, 

VIC 20, COMMODORE 16, 

AND PET OWNERS 

A complete self-tutoring BASIC programming course 
is now available. This course starts with turning 
your computer on, to programming just about 
anything you want! This course is currently used 
in both High School and Adult Evening Education 
classes and has also formed the basis of teacher 
literacy programs. Written by a teacher, who after 
having taught the course several times, has put 
together one of the finest programming courses 
available today. This complete 13 lesson course 
of over 220 pages is now available for the COM- 
MODORE 64, VIC 20, COMMODORE 16 and PET 
computers and takes you step by step through a 
discovery approach to programming and you can 
do it all in your leisure time! The lessons are filled 
with examples and easy to understand explanations 
as well as many programs for you to make up. At the 
end of each lesson is a test of the information 
presented. Furthermore, ALL answers are supplied 
to all the questions and programs, including the 
answers to the tests. Follow this course step by 
step, lesson by lesson, and turn yourself info a 
real programmer! You won't be disappointed! 

We will send this COMPLETE course to you at 
once for just $19.95 plus $3.00 for shipping and 
handling (U.S. residents, please pay in U.S. funds). 
If you are not COMPLETELY satisfied, then simply 
return the course within 10 days of receipt for a 

FULL refund. 

Now available! a 200 page course 
exclusively on sequential and rel- 
ative files using a unique approach 
for those with very limited file programming ex- 
perience - set up your own personal and business 
records! — disk drive a must — same author — 
same guarantee — same cosl — (his course for 
all computers except Vic 20. 




Fill in the coupon or send 


a facsimile. 


| NAME: 


TP 


J addrfsr- 


1 CITY 


| PRfW/RTATF- 


J POSTAL/ZIP CODE: 


j I desire the BASIC program- 


Any complete course: $19.95 


| ming course for: 


Postage and handling: $3.00 


| Commodore 64 C VicD 


Total: $22.95 


1 Petf. Commodore 16 


Send Cheque or Money Order to: 


1 1 desire the follow up 7. '. 


Brantford Educational Services 


1 course on relative and 


6 Pioneer Place, 


sequential files (for all above 


Brantford. Ontario, 


computers but Vic 20). 


Canada N3R 7G7 



INTRODUCING 



THE HRT SUPER-RES 



GRAPHICS BOARD 




This is a graphics board which is universally compatible with all models of 
PETs. With Superpets (both 2 and 3 boards) It works equally well on both the 
6502 and 6809 side as well as with OS-9. The graphics board is Ihe result of 
two years of R&D which began in Nov 83 with the first prototype Then 
starting in Mar 84 it was test marketed for four months through TPUG 
Magazine The original model only worked on the 2001 with a resolution of 
320 x 200. At Ihe 84 TPUG Conference the 4016 and 4032 models were 
unveiled. Then in Dec. 84 at the Superpet chapter meeting the 8032. 8096 
and 9000 models were introduced. Over the last year these different models 
were held tested in schools, universities, business and homes. The HRT 
SUPER-RES GRAPHICS BOARD was then designed with the results Irom 
these tests and input from expert users 

The window size is 700 hor by 300 ver. for the 8032's. 8096s and 9000'sand 
640 x 200 for all other models. However the card has an even larger resolution 
of 1024 x 512 pixels. The most that can be displayed on the monitor is 
determined by the window size but the card supports scrolling left, right, down 
and up to view the entire graphics area. This window can be defined to any 
size, can be located anywhere on the monitor and can scroll about the 1 024 x 
512 pixels The graphics can even be overiayed on top of the text without 
interfering (even if both text and graphics are scrolling). 
To accomplish this high resolution the board has its own 64K of ram. Another 
attractive feature is that this extra memory can alternatively be used as a ram 
disk. 

The above picture has a window size of 700 x 300 and can be scrolled about to 
reveal the entire 1024 x 51 2 pixels. The picture of the girl is 280 x 192 and 
only one image can be shown on an Apple II Computer, (the original source) 
A large software package is included with the purchase of the super-res board. 
It includes plotting utilities, sketching routines, turtle graphics, algebaric 
graphs, animation routines etc. 

Ease of installation is one of the important design features. The circuit board 
simply plugs into the mother board under the monitor with no soldering 
required. 

Please send cheque or M.0. for S200 00 U.S./S25:>.0QCdn. plus S5 shipping 
and handling (Ontario residents please add 7% Prov. Sales Tax) To HIGH RES 
TECHNOLOGIES 16 ENGUSHIVYWAY. TORONTO. ONTARIO M2H 3M4. 
Note: Please specify computer and disk drive model numbers. 
(416)497-6493 



Amiga Dispatches 



by Tim Grantham 

On a sea of wild rumours about CBM's 
imminent demise, the Amiga has sailed 
on, propelled by waves of new software, 
buoyed by continuing excitement over its 
extraordinary capabilities. No other com- 
puter has had so much software available 
so soon after its debut. Yet it's not an 
easy computer to market — there's just 
nothing else like it. Of the one million (!) 
computers Commodore sold in the last 
quarter of 1985, only 10,000 were 
Amigas. But chin up, Amigos! We believe 
that given time, the Amiga will boldly go 
where no computer has gone before. 
Meanwhile, more news from the 
frontiers. 

CP Update 

The controversy over copy protecting 
software for a machine designed from the 
bottom up for multitasking rages on. 
Electronic Arts has continued to press for 
innovative approaches. For a time, they 
were considering a kind of optical dongle 
used in England: a piece of coloured 
plastic that the user looks through when 
booting up the program. Cheap to manu- 
facture (but difficult to synthesize at 
home), they enable the user to read a 
series of encrypted characters on the 
boot-up screen. Once these are entered, 
the program continues. 

It's not only end-users who are fighting 
E A on the CP issue — witness the follow- 
ing from one software developer: 

#\ 6188S1/Software 

25-Jan-86 02:53:39 
Sb: #6132-electronic arts 
Fm: ben blish 72667,1341 
To: Electronic Arts 76004.237 

. . . The package my company is creating 
is priced in the $1 000.00 range... 
Eminently Stealable . . . and it is NOT copy 
protected. If it is stolen, among other things, 
I will lose my home, and probably my wife. 
However, human nature is generally good, 
and I will take the chance, and I will not take 
the chance of aggravating my bona fide 
customers. Anyway, I am not a thief, lots 
of others aren't either, and YOU can afford 
to take the chance. Please do so. And 
that's my Opinion. — Ben Blish, SoftGr- 
cuits Inc; 305-721-2707 anytime — 
EA responded thusly: 

#: 7244 Si/Software 

04-Feb-86 19:32:56 



Sb: #EA Copy Protection 
Fm: Electronic Arts 76004,237 
To: all 

Okay. I have a proposal: What is your opi- 
nion if we: a) continue to sell our utilities pro- 
tected, although the protection is of the 
type that lets you make backups. When 
booting, it requests that you insert the 
master disk, to verify the signature. 
However, b) enclosed in the package is a 
card that lets you, with proof of purchase, 
buy a completely unprotected version for 
say $10-$20. 1 think that most users will not 
be upset at just using the first version, but 
for those who really need it, the un- 
protected version will be available. To pur- 
chase the unprotected version, we will pro- 
bably have on the card some sort of site 
license/non-piracy agreement to sign, 
and/or we might encrypt (but not display) 
your name, address, etc. in the disk we 
send you. Again, this is just a proposal, so 
I want your feedback. Thanks. 

Jeff J. - EA 

Response to this has been generally 
favourable. EA is to be commended on 
their continuing dialogue in this matter. 
Drop a line to EA if you have any con- 
structive ideas on this very important 
subject. 

As a final note, one company already 
has a copy program in beta-test that has 
proved capable of backing-up Deluxe 
Paint, and all other EA software. 

Software Bulletins 

These just in . . . Micro-Systems Software 
continues to lead the way in productivi- 
ty software with its Online! terminal soft- 
ware, for which two (free) upgrades have 
already been issued. File transfers with 
CompuServe's B protocol are included in 
the latest version (vl.26). Analyze!, a 
spreadsheet, was released in January, 
and Scribble!, a word processor, is cur- 
rently in beta-test and should be available 
shortly ... By the time you read this, TDI 
software will have released its Modula-2 
compiler (not copy -protected). Borland, 
famous for its Turbo Pascal, should have 
the Amiga version ready by the middle 
of this year. . . Aegis' Pro Draw CAD 
software will share AutoCAD's program- 
mability. Prices on latest Aegis software 
are as follows: Animator/Images combo. 
$139.95, Images $79.95, Impact $199.95, 
Draw $199.95 (all prices US). . . 
Michael Reichmann of Batteries 



Included has announced that Bl are 
developing a version of the Degas draw- 
ing software, considerably enhanced from 
the Atari ST version. The author is Tom 
Hudson, Availability — some time this 
summer. BI has also announced that no 
forthcoming Amiga programs from them 
will use any CP. . . Paul Higginbottom , 
Amiga Product Manager, and well-known 
to TPUG members, has announced the 
imminent arrival of AmigaTERM, C-A's 
own terminal software. . . Ben Blish, of 
Soft Systems, has sent out copies of his 
PCLO printed circuit board CAD pro- 
gram, which makes full use of Amiga's 
graphics, mouse, and multitasking en- 
vironment, for beta-test. He has promis- 
ed that there will be no copy -protection 
on it. . . 

Tom Casey, co-author of Deluxe Video 
Construction Set, appeared on the 
Amigaforum on CompuServe to explain 
the delay on release of the program. It 
is currently in beta-test, but he wants to 
get all the kinks out of this extremely 
powerful and innovative software. With 
fingers crossed, he hopes it will be ready 
in March. DVCS can import any image, 
sound or music in the IFF format jointly 
developed by EA and C-A. . . The new 
ROM Kernel 1.1 manuals are being ship- 
ped to developers and include the 
necessary info on the printer drivers, so 
all the people crying out for a way to get 
their printer into Preferences shall soon 
be quieted . . . Bob Perez has handed over 
the porting of his VMCO terminal pro- 
gram for the Mac to the legendary Cap- 
tain Crunch, aka John Draper. . . 

Ashton-Tate is soliciting requests for an 
Amiga version of dBaselll. If you would 
like to see this happen, leave Email to the 
Sysop of the Ashton-Tate forum on CIS, 
Steve Silverwood [76703,3035] . . . C-A is 
rumoured to be preparing a disk full of 
PD software, including Andrew Finkle's 
version of MicroEMACS. . . Finally, 
there are apparently different versions of 
the IBM emulator in beta-test, resulting 
in conflicting reports of its ability to run 
various MS-DOS programs. Some can get 
Borland's Sidekick program to run, 
while others get only crashes. One per- 
son claims to have been able to run CP/M 
software on the Amiga, using an MS-DOS 
CP/M emulator running under the IBM 
emulator! 

Hardware News 

Unlike those of us in the frozen north, 
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user groups in the US are getting 
demonstrations of new peripherals. Larry 
Miller of FAUG (First Amiga Users 
Group) gave a lengthy report on CIS of 
a demo of a frame grabber called LIVE, 
from A-Squared Systems. The unit plugs 
into the bus expander on the right side 
of the computer and, in combination with 
the software, digitizes a standard com- 
posite colour video signal into RAM in 
IFF format (so the Deluxe series can use 
it), for about 300 dollars. It should be 
available in the second quarter, providing 
the FCC doesn't hang it up. It does tie 
up the computer so that no other tasks 
can be performed while it is in operation, 
and it is also a 'bus end': it does not pass 
on the other signals on the bus. This 
means you would not be able to use it in 
combination with other 'bus end' units, 
such as the hardware IBM emulator is 
rumoured to be. A-Squared is working on 
a 'Professional' model (at much higher 
cost) for those who want to process Land- 
Sat photos, for infrared and X-ray image 
analysis, and so on. 

While we are on the subject of video, 
the Genlock interface is ready for release. 
William Volk, of Aegis Development told 
me that he had used a production (not a 
prototype) unit to overlay a rotating 3-D 
NBC logo created with Aegis Draw on 
a television picture from a VCR, on the 
Amiga's monitor. 

Two reps from Tec mar gave a short 
demo of their Hard Disk and Expansion 
Module at the Cleveland Amiga Users 
Group. Apparently, only FCC approval is 
required, though Tecmar says there is no 
way they can meet the current demand; 
they just can't build them fast enough. 
Microforge is also producing hard disks 
in various capacities, but Paul Higginbot- 
tom reports that both Microforge and 
Tecmar's products make the mistake of 
stopping other processes when they ac- 
cess the drive. Carl Sassenrath, author 
of the EXEC on the Amiga, has assured 
everyone that this is not the fault of the 
Amiga OS. 

A-Time is a clock-card that plugs into 
the parallel port. It has a parallel port on 
the back, and sells for $49.95. It's 
available from Akron Systems Develop- 
ment, P.O. Box 6408, Beaumont, TX 
77705. 

It looks like CBM's encounter with 
Andy Warhol has not proved too rich for 
their blood. They are continuing their 
promotion of the Amiga as a tool for ar- 
tists by announcing their sponsorship of 
the Amiga Studio Theatre in the Cana- 
dian Pavilion at Expo 86. CBM will pro- 
vide 20 Amiga computers for use by per- 
forming artists across Canada, to create 



new works or to integrate special effects 
into their performances. 

Some Users are exploring the Amiga's 
multi-user capabilities. Ron Williams has 
reported that after entering newcli ser: 
at the CLI, a message was output to the 
serial port saying new cli, and a prompt 
appeared. But it did not seem to be ac- 
tive because no corresponding window 
appeared on the Amiga's monitor. John 
Eric Hinkley cleared up that little 
mystery by saying that the Amiga serial 
port does not appear to respond to 
delimiters like CR. It seems you have to 
send 200 characters to get the serial port 
to give the line to the new cli. He wrote 
a small 9600-baud terminal program for 
his IBM PC that buffered what was 
entered, and when CR was pressed, it 
sent the line padded with extra spaces to 
bring it up to 200 bytes. He was able 
to get the machine to respond to such 
commands as dir. list, info, and so on. 
Running programs from the serial port 
proved problematic because they 'attach' 
themselves to the Amiga's keyboard, and 
their input/output cannot be reset for the 
serial port without encountering an error 
stating that aer: has already been attach- 
ed by another process. I'm sure we 
haven't heard the last word on this sub- 
ject, though. 

Other News 

A new Amiga magazine has debuted call- 
ed Amazing Computers. Word is that it 
is packed entirely with Amiga-specific ar- 
ticles and that it is off to a good start. 
Subscriptions are SZl.'OO (in the US) and 
can be had by writing to PIM Publica- 
tions, P.O. Box 869, Fall River, MA 
02722, or calling (617) 679-3109. 

Charles Brannon, the COMPUTE! 
Amiga columnist and editor, has a 
regular presence on the Amigaforum. 
You can send ideas and comments to him 
care of PPN 76004,73 on CIS. 

Lastly, the following message should 
give you some idea of the changes in 
CBM's attitude towards its customers: 

#: 7214 S9/SoftwareDevelopment 

04-Feb-86 08:40:47 
Sb: REV. 1.1 MANUALS 
Fm: FRANK SCHWAB 73137,3142 
To: BELA 76703,3015 
Bela — Took your advice and called Com- 
modore Software Support today, Lisa there 
told me that yes, even we non-developer 
scum who bought only the developers' 
manuals set, will gel the revision 1.1 
manuals. Who at Commodore is respon- 
sible for this outrageous behavior, suppor- 
ting users after they buy their machine, and 
providing software and manual updates? 
Absolutely unheard of! BUT I LIKE IT!!!! □ 



The Walker 

1) Insert your COMAL disk in drive*. 

2) Type LOAD "C64 COMAL*", 8 

3) Type RUN (starts COMAL) 

4) Type AUTO 

(COMAL provides the line numbers) 

5) Enter the program lines shown below 

(COMAL indents linen for you) 

6) Hit RETURN key twice when done 

7) Type RUN 

Watch an animated sprite hobble 
across the screen. Change the (99) 
in tine 450 for really fast walking 

0010 setup 

0020 repeat 

0030 walking 

0040 until key$="q" //Q to Quit 

0050 // 

0060 proc setup 

0070 brue:=14; pink: = 10 

0080 white:=l; black:=0 

0090 define Images 

0100 repeat 

0110 input "speed (1-10): ": speed 

0120 until speed>=l and sp«ed<=10 

0130 background black 

0140 setgraphic 

0150 spriteback blue.pink 

0160 spritecotor l.white 

0170 spritesize 1, false, false 

0180 plottext 1,1, "press q to quit" 

0190 endproc setup 

0200 // 

0210 proc define'images closed 

0220 dim shape J of 64, c$ of 1 

0230 shapej(l:64):="" 

0240 shape$(64):=chr$(l)//multicolor 

0250 c$:=chr$(0) 

0260 for x=22 to 63 do shape$(x):=c$ 

0270 c$:=chr*.(170) 

0280 for x=l to 21 do shapet(x):=c* 

0290 define O.shapeJ 

0300 c$:=chr*(20) 

0310 for x=22 to 42 do shape*(x):=c$ 

0320 define l.shapet 

0330 define 3,shape$ 

0340 cl:=chr$(60) 

0350 for x=43 to 63 do shape$(x):=ct 

0360 define 2,shape$ 

0370 endproc define'images 

0380 // 

0390 proc walking 

0400 for walk:=l to 319 div Bpeed do 

0410 x;=walk*speed 

0420 y:=100+walk mod 4 

0430 spritepos l,x,y 

0440 identify l.walk mod 4 

0450 pau 3 e(99) 

0460 endfor walk 

0470 endproc walking 

0480 // 

0490 proc pause(delay) closed 

0500 for wait:=l to delay do null 

0510 endproc pause 

* If you don't have COMAL yet, order a 
Programmer's Paradise Package -tl9.95. 
It includes the complete COMAL system 
plus over 400 pages of information. Add 
$5 more to get our 20 interactive lesson 
Tutorial Disk. Add *2 shipping. Visa/MC 
or US funds check accepted. Send to: 

COMAL Users Group USA 

6041 Monona Drive, Room 109 
Madison, WI 53716 
phone 608-222-4432 
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Extending the cruise 

More hardware and software 
for the musical Commodore 64 



by Tim Grantham 

Since my last article about music soft- 
ware and hardware for the 64 {'Cruising 
the Sea of 64 Music', November 1985), I 
have had the opportunity to examine 
some new products, and to take a closer 
look at some mentioned only briefly in 
that article. 

Melodian keyboard 

Melodian is primarily a manufacturer 
of keyboards, and their expertise shows. 
The Melodian Musical Keyboard looks 
good and feels good, the keys having 
quite the best action of all the add-on 
keyboards for the C-64 that I've tried. It 
also has a three-and-a-half octave range, 
which means much less switching of oc- 
taves from within the program. The 
keyboard has two connectors to the C-64: 
a large plug that is inserted into the user 
port, and a smaller one that plugs into the 
rear joystick port. 

The same straight-forward craftman- 
ship has been put into the accompanying 
software. The ConcertMaster program 
is completely menu-driven, and essential- 
ly emulates a three -track tape deck and 
polyphonic synthesizer. Each voice of the 
SID chip is assigned its own track, and 
each track can be recorded to, played 
back, monitored, muted, and so on, com- 
pletely independently. The usual pro- 
cedure is to record one track first, then 
record a second while listening to the first 
play back. A third track is recorded in the 
same fashion. This is deliberately reminis- 
cent of the way a piece is assembled at 
a professional recording studio, track by 
track, until all sixteen or thirty-two 
tracks have been recorded. You can also 
create your own sounds by changing any 
of the instruments provided by the pro- 
gram. The major features of the SID chip 
are all under your control, including the 
filters, synchronization, and ring 
modulation . 

I found the keyboard and software com- 
bination ideal for musical 'sketching'. 
Anything longer becomes a problem, 
because of the lack of editing functions. 



There is no way to change just one or two 
notes in what you've previously record- 
ed. But if you have enough digital dex- 
terity (no pun intended), it's very easy to 
lay down a melodic line, then experiment 
with different harmonies while listening 
to the melody. Once I'm happy with my 
three-part arrangement, I store it to disk 
for later transcription to a full-featured 
music editor like Music Assembler 64 or 
Master Composer. 

Concert Master has a colourful, though 
simplified, score display that scrolls rapid- 
ly from right to left as the music is played. 
It's not of much use except to reinforce 
the relationship between the pitch of the 
notes and their position on the musical 
staff. 

Melodian also has an instruction pro- 
gram called Rhythm Composer, that 
makes a game out of learning musical 
notation. The player is required to match 
a musical phrase played by the computer. 
The program is a little too precise, 
perhaps: a novice is likely to be frustrated 
with the rigidity of the timing. Human be- 
ings are not metronomes, and time values 
in music are not always exact. 
Nonetheless, this program can be 
valuable simply for the discipline it 
enforces. 

Melodian has also released Program- 
mer's Tool Kit, a book containing BASIC 
source listings of programs that read the 
musical keyboard and read and create 
music files. Another recent addition is the 
Melodian ScorcMastcr, which prints out 
ConcertMaster files in musical notation . 
Any printer that can emulate the 1525, 
1515, or the MPS 803 in graphics mode 
can be used. 

MacMusic 

A fine program for the beginner is 
Passport Design's MacMusic, so named 
because it emulates the user interface of 
the Apple Macintosh, complete with drop- 
down menus and icons. You can do 
everything by just moving the pointer 
with the joystick to the appropriate spot 
on the screen and pressing the fire but- 
ton. It's a very smooth implementation, 



and the only frustration I encountered 
was with the slow speed of the pointer, 
as I moved it around the screen. 

You literally draw the music onto the 
screen (the pointer becomes a paint- 
brush). Each voice is drawn as a line in 
a different colour. The length of the line 
determines the duration of the note, and 
its vertical position on the screen defines 
its pitch. You can choose from a number 
of fixed sounds, and several different 
musical scales. You can have a lot of fun 
drawing in a blues scale, or the pentatonic 
scale, because 'wrong' notes are less ap- 
parent in these scales. 

Two other solid features of this pro- 
gram are the ability to change either the 
meter (number of beats per measure) or 
the tempo for any or all measures in the 
music, allowing complex rhythms to be 
played. You can also change the instru- 
ment being played in any bar, but there 
is no facility for creating your own 
sounds. 

This program is excellent if you like a 
'sandbox' approach to creating music. 
You can paint great swathes of 
polyphonic sound quickly and easily, with 
over a dozen different timbres. When you 
want to start entering individual notes, 
carefully timed and placed, however, the 
approach becomes awkward and time- 
consuming. A display of a piano keyboard 
runs up one side of the composing screen , 
so you know exactly where to draw the 
note. But it is no faster than it would be 
to write out what you want in musical 
notation. This is mitigated by the fact 
that, once the music has been entered, it 
is easy to change. You can edit your 
music note by note, or you can use the 
cut-and-paste functions to move around 
chunks of the score. This is especially 
useful when you want to repeat sections 
of the music. Once they have been cut out, 
they can be copied as many times as 
necessary. The immediate playback that 
the computer offers, combined with the 
ease of editing, make this a worthwhile 
program in many respects. However, I 
think that someone who already has 
musical training might prefer a program 
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with more a more utilitarian approach. 
Passport Design's also publishes Com- 
puter Hitware, arrangements of popular 
contemporary music on disk for the C-64. 
Current disks include selections by the 
Police, Van Halen, Duran Duran, and 
others. Also available is Computer Sheet 
Music, which teaches keyboard technique 
and musical notation by displaying songs 
on the screen in large-note format. The 
program works in conjunction with 
Passport Designs's MUSIC 64 keyboard, 
or any MIDI keyboard and interface. 

FastFingers 

In FastFingers, author Dan Laskowski 

has taken an approach entirely different 
from any I've seen before. He has utiliz- 
ed all the resources of the SID chip to 
create a performance lead synthesizer 
and sequencer. By combining all three 
voices into one, he has created 256 
remarkable sounds — 'presets' in syn- 
thesist's parlance. You can also create 
your own sounds, using the programs ex- 
tensive control functions and built-in 
special effects, by overwriting the 
presets. These new presets can be saved 
to another disk. 

The list of special sound effects is im- 
pressive. It includes: 

• Flange detunes each of the oscillators 
with respect to the others. 

• Glide causes the pitch of each note to 
slide to the pitch of the next one. 

• Wah adds a wah-wah effect to the 
notes. 

• T re me I o causes a rapid oscillation in 
the filter cut-off frequency, giving the im- 
pression of a rapidly-varying loudness. 

• Weow makes an upward or downward 
slew of the pitch as the key is released. 

• Shftr results in a phase shift of the 
sound by detuning only one of the voices. 

The sequencer in FastFingers has also 
been modelled on those used by profes- 
sionals. These work very much like super- 
efficient tape recorders, but without any 
tape. To use the sequencer in FastF- 
ingers, you press the Rcord key, after 
setting the speed, and play the sequence. 
Press Stop when done. Now you can Play 
it (backwards or forwards), speed it up or 
down, punch in (change individual notes), 
Cut, Splice, and so on. You can also 
record arpeggios (series of notes taken 
from a single chord) that can be triggered 
from the keyboard, in much the same 
fashion. Laskowski claims you can store 
up to forty minutes worth of music in the 
sequencer. 

Yet another unusual aspect of the pro- 
gram is that it uses the piano keyboard 



made by Mattel for its Intellivision home 
computer. The 64's typewriter keyboard 
can also be used, but the Intellivision 
keyboard works very well. In one respect, 
it is even superior to the Melodian 
keyboard: it has forty -eight keys to the 
Melodian 's forty. Laskowski has created 
an adaptor for the keyboard, which is in- 
cluded with the software. If you can't find 
one of these keyboards locally, Laskowski 
himself has a limited number for sale (see 
address below). 

All of the above capabilities of Fast- 
Fingers are standard features on today's 
electronic instruments, and Laskowski is 
to be congratulated for successfully pro- 
gramming them into the C-64. 

Yet I have some doubts about the prac- 
ticality of the approach. The software has 
been designed very much with the per- 
forming musician in mind. It is possible 
to control the program without using a 
monitor, but lugging a C-64 and a disk 
drive from gig to gig may not be worth 
the trouble even for those musicians who 
are interested in the initial investment in 
the system. An SX-64 would solve the 
problem handily, but they are hard to get 
these days. 

Secondly, despite the great sounds 
Laskowski has coaxed out of the SID 
chip, the quality may just not be good 
enough for serious musicians. The SID 
has a signal-to-noise ratio of only 48 
decibels, and notoriously fickle filters. 
Laskowski does claim to have significant- 
ly improved the dynamic range of the SID 
by processing the sound through an add- 
on DBX expander. 

Laskowski should consider adapting his 
program for the Melodian keyboard, now 
that Melodian has released programming 
documentation for it. The Intellivision 
keyboards are going to be hard to get. 

The organization of the controls in 
FastFingers is dense, but quite logical. 
The same cannot be said of the documen- 
tation , which suffers from a lack of clari- 
ty and friendliness. 

SID Editor 

As a sysop of the Commodore Music and 
Graphics forum on CompuServe, I can 
get some idea of the success of a music 
creation program from the number of 
files submitted. For a long time, Master 
Composer was the favourite, not only 
because of its ease of use and its editing 
features, but because it was one of the 
first to create 'stand-alone' files (files that 
can be transmitted and run as indepen- 
dent programs). Master Composer has 
been toppled from pre-eminence, though, 
by the appearance of many pieces created 
with Harry Bratt's SID Editor. This very 



powerful program can be found in Ail 
About the Commodore 64, volume 2, by 
Craig Chamberlain. Almost all the pro- 
grams in this book are available from 
COMPUTE! Publications on a disk, 

SID Editor gives you note-by -note con- 
trol over every aspect of the sound. This 
program pushes the SID chip to its limits. 
Almost every imaginable musical effect 
can be created: tricky time signatures, 
syncopated rhythms, tempo variations, 
portamento, vibrato, ties and slurs. The 
same goes for the creation of the sounds 
themselves, with the availability of such 
features as filter sweeps and pulse-width 
sweeps, detuning, transposition, and so 
on. 

But what really sets this program apart 
is that, in combination with the book, it 
can be used by either a total novice or a 
trained musician. The book provides a 
very good introduction to all the basics 
of musical notation and synthesizer 
technique. Almost every feature of the 
program can be accessed with a joystick. 
More experienced users can enter com- 
mands and note values through the 
keyboard. 

Each note is displayed in three ways: 
as one of the keys on a keyboard, as a 
note on a staff, and as a letter. You can 
change any aspect of any note anywhere 
in the piece. One very powerful feature 
is the ability to define up to 16 phrases 
of music that can be called or redefined 
at any time. They can even consist entire- 
ly of commands, so that you could, for in- 
stance, call one phrase of notes with 
another phrase of commands, ringing the 
notes through a series of changes in key, 
articulation, tempo, and so on. In the 
hands of an expert, large pieces can be 
constructed very efficiently, conserving 
memory. 

Like Master Composer, files created 
with SID Editor can be added to, and 
controlled by, other programs. Individual 
voices can be turned on or off; the music 
can be stopped and restarted from where 
it left off; and individual sections of the 
music can be flagged, so that the calling 
program can synchronize its actions with 
the music. 

Four utility programs provided with 
SID Editor enable you to list the music, 
extract sections, append one or more files 
to another, and cross-merge files — use 
one of the voices of one file for the voice 
of another. This last is useful for rear- 
ranging the voices in one file. 

Music Assembler 64 

SID Editor is a very complete program, 
but even it does not have the power of 
MA64 by Nick Sullivan, so-called because 
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the music is written in a source code that 
has much in common with BASIC, and 
then assembled by the program into a 
playable 'object code'. MA64 is a commer- 
cial version, rewritten and greatly ex- 
panded, of Music Assembler 64, a TPUG 
freeware program available on disk (C)3>1 . 

In addition to every music control 
feature of SID Editor, MA64 provides 
such arcane features as waveform 
scheduling, where each note can be set 
up to switch between different 
waveforms while it plays; pulse width 
vibrato, a controllable oscillation of the 
pulse width; and duration patterns, which 
work like a sequencer, enabling a series 
of pitches to be played in the same 
repeating rhythm. If you can think of 
some new tricks to teach the SID chip, 
MA64 even gives you a way to poke the 
SID directly from within the object code! 

One feature I particularly like is a 
variable delay on the vibrato. When 
vibrato is used on regular instruments — 
a flute, say — the vibrato is not added by 
the player until a second or two after the 
note is started. The only traditional in- 
strument that comes readily to mind 
where this is not done, is the pipe organ. 

MA64 is superior to SID Editor in its 

implementation of vibrato and glissando, 
because it defines the depth of the vibrato 
and the sweep rate of the glissando in 
terms of intervals, rather than frequen- 
cies. The depth of the vibrato in SID 
Editor must be adjusted as the base pitch 
of the note changes, because as the note 
gets higher, the musical interval defined 
by the difference in the upper and lower 
frequencies becomes smaller. To the ear, 
the depth of the vibrato becomes 
shallower, even though the frequency 
variation is the same. MA64, on the other 
hand, sets the depth of the vibrato as a 
fraction of an interval, which is indepen- 
dent of the base pitch of the note. To the 
ear, the vibrato depth stays the same, no 
matter how high or low the base 
frequency. 

This program is not for the novice: 
some knowledge of music is required. 
MA64 is a mini -language, and as such, 
can be a little daunting even to those who 
can read music, but who have little 
understanding of programming. Those 
who are familiar with -BASIC will find 
themselves in friendly territory though, 
for MA64 uses many of the statements 
found in BASIC. Below, I have listed a 
short sample program in MA 64: 

IB sys 592 

23 [0] :tf=0: ;initialize 
transposition factor 



30 for ia=1 to 5 
40 gosub motif 

S0 tf-tf+1: .t tf 

60 next ia 

70 end 

80 /motif 

90 c3h:e :a:g:c4 :b3q :a:gh 

100 return 

This can be entered just like a BASIC 
program, using the built-in screen editor; 
you can load or save it, and you can even 
use editing utilities like POWER. The 
SYS in line 10 invokes the 'assembler', 
which generates music 'object code' from 
the succeeding statements. The program, 
when assembled, will play the note values 
in line 90 five times, transposing it up one 
semitone each time. 

Sullivan provides a tutorial program on 
the disk, and on-line help files, as well as 
SID Monitor, which displays what's hap- 
pening in all the SID's registers as the 
music is being played. 

it's been fun. . . 

All of the above programs, with the ex- 
ception of FastFingers, provide excellent 
arrangements of classical and contem- 
porary music as demonstrations, and 
complete, readable documentation. It's 
been a pleasure exploring all of these pro- 
grams. "Music hath charms ..." so they 
say, and that seems to be reflected in the 
generally high quality of music software 
for the Commodore 64. 

ConcertMaster, RhythmMaster, 
ScanMaster, Programmer's Toot Kit, 
Musical Keyboard, by Melodian, Inc., 
970 W. McNab Road, Fort Lauderdale, 
Florida SSS09. ($29.95 US each for the 
software, $99.95 US for the keyboard). 

MacMusic, by Passport Designs, 625 
Miramontes Street, Half Moon Bay, 
California 94019 ($49.95 US). 

FastFingers by Dan Laskowski, See- 
Thru Enterprises, 10882 Shenandoah, 
Windsor, Ontario N8R 1B5. (519) 
735-2995 ($119.85 US for keyboard, adap- 
tor, and software; $59.90 US minus 
keyboard; $24.95 US for software alone). 

All About the Commodore 64, Vol. 2, by 

Craig Chamberlain. Published by Com- 
pute! Books, Inc., P.O. Box 5406, 
Greensboro, North Carolina 27403 ($16.95 
US for the book, $12.95 US plus shipping 
for the disk). 

MA64.v2, by Nick Sullivan. Distributed 
by Wilanta Arts, 694S Barrisdale Drive, 
Mississauga, Ontario L5N 2H5 ($29.95 
Cdn., $19.95 US). □ 
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Commodore 128 Memory Map 



by Paul Blair 

and Jim Butterfield 

By this time, memory maps for the Commodore 128 are sprouting 
up all over the place. But on these pages, Australian writer Paul 
Blair gives us a memory map with a difference. Paul has cross- 
referenced many locations on the 128 with their C-64 equivalents, 
so programmers who already have some familiarity with the 
layout of the 64 will more readily be able to get their bearings 
on the new machine. Many thanks to Paul for sharing this work 
with us. 



This memory map has been prepared to assist programmers 
understand more about the structure of BASIC 7.0 as im- 
plemented in the Commodore 128 computer. As the machine 
also has a C-64 operating mode, with BASIC 2.0, the map 
reflects common entry points as far as possible. 

I have drawn on work done by Jim Butterfield. Jim had access 
to early releases of the C-128, and was generous in supplying 
information to friends. Without his assistance, this map would 
have been a long time coming. My thanks to him. 

The information here represents our ideas of what is in Release 

of the C-128 BASIC and Kernal ROMs. Consider this Version 

1 of the map: it was completed in December, 1985, and it is poss- 
ible that ROM revisions after that date will invalidate some of 
the data. It has not been the policy of Commodore to release 
memory maps to the general public, so we offer this map to help 
you get more from your Commodore computer. 



BANKO 



Label C-128 C-64 



D6510 

BANK 

PC-HI 

PC-LO 

S-REG 

A-REG 

X-REG 

Y.REG 

STKP1P 

INTEGR 

CHARAC - 

ENDCHR 



TRMPOS 

VERCK 

COUNT 

DIMFLG 

VALTYP 

INTFLG 

GARBFL 

SUBFLG 
INPFLG 

TANSGN 

POKER 

LINNUM 

TEMPPT 

LASTPT 

TEMPST 

INDEX1 

INDEX2 

RESHO 

TXTTAB 



0000-1 

0002 

0003 

0004 

0005 

0006 

0007 

0008 

0009 

0009 

0009 

OOOA 



000B 
OOOC 

30QD 
000E 
00OF 

0010 

0011 

0012 
0013 

0014 

0015 

0016-17 

0018 

0019-1A 

0018-23 

0024-25 

0026-27 

0O28-2C 

002D-2E 



0000-1 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 



Flag: scan lor 
quole at end 
of string 
0009 
OOOA 
000B 
OOOC 
OOOD 

oooe 

O00F 

0010 
0011 

0012 

0014-15 

0016 

0017-18 

0019-21 

0022-23 

0024-25 

0026-2A 

002B-2C 



Description 

VO port, similar to C-64 

Monitor use; Program counter MSB 
Program counter LSB 
Processor status 
Accumulator (.A) store 
X-regtster (.X) store 
Y-regisler (.Y) store 
Stack pointer (SP) store 

Search character 



Screen column from last tab 

Flag = LOAO. 1 -VERIFY 

Input butter ptr/# ot suoscnpts 

Flag, default array dimension 

Variable type: SFF = string, 

S00 = numeric 

Var type: $80 = integer. $00 = floating 

point (FLP) 

Flag DATA scan/LIST quote/garbage 

collection 

Flag: subscript refuser lunclion call 

Flag: $00 = INPUT, $40 = GET, 

$98 = READ 

Flag: TAN sign/comparison result 

Current I/O device # 

Integer value (line #, GOTO, POKE elc) 

Pointer: next string stack Brrtry 

Pointer: current string stack entry 

Stack. 9 bytes for 3 string pointers 

General purpose pointer 

Genera! purpose pointer 

Workspace used by multiply and divide 

Pointer: start of BASIC (for Bank 0) 



vARTAB 

ARYTAB 

STREND 

FRETO 

FRESPC 

MAXMM1 

CURLIN 
TXTPTR 

FORM 

FNDPTR' 

DATLIN 

DATPTR 

inpptf 

VARNAM 

VARPNT 

FDECPT* 

LSTPNT 

ANDMSK" 

FORPNT- 

EORMSK - 

VARTXT 

OPPTR- 

OPMASK 

GRBPNT 

TEMPF3' 

DEFPNT - 

DSCPNT 

HELPER 

JMPER 

TEMPF1 

PTARG1 

PTARG2 

STR1 

STR2 

POSITN 

MATCH 

ARYPNT 

HIGHDS- 

HIGHTR 

TEMPF2 

DECCNT 

GRBTOP 

DPTFLG" 

LOWTR- 

EXPSGN 

FACEX 

FACHO 

FACSGN 

ARGEXP 

ARGHO 

ARGSGN 

AR1SGN 

FACOV 

FBUFPT 

AUTINC 

MVDFLG 

KEYNUM 

NOZE* 

SPRNUM - 

HULP 

KEYS1Z- 

SYNTMP 

DSDESC 

TOS 

RUNMOD 

PARSTS 

POINT' 

PARSTX 

OLDSTK 



002F-30 
0031-32 
0033-34 
0035-36 
0037-38 
0039-3A 

003B-3C 
003D-3E 

O03F 

003F-4A 

0041-42 

0043-44 

0045-46 

0047-4B 

0049-4A 

O049-4A 

004B-4C 



004D-4E 



004 F 
0050-51 



0052-0054 

0055 

0056-5S 

0059 

TEMPFl+2 

TEMPF1+2 

TEMPF1+4 

TEMPF1+7 

TEMPF1 + 10 

TEMPF1 + 11 

005A 

005A-5B ■ 

005C-005D 

005E 

005F-60 

0061 



0062 

0063 

0064-67 

0068 

006A 

006B6E 

006F 

0070 

0071 

0072-73 

0074 

0076 

0077 



0078 

0078 

0079 

007A-7C 

007D-7E 

007F 

0080 

008C 

0081 

0082 



002D-2E Pointer start of variables (Bank 1 ) 

002F-30 Pointer: start of arrays 

0031 32 Pointer: end of arrays + 1 

0033-34 Pointer: string storage (moving down) 

0035-36 Utility string pointer 

0037-3S Pointer: limit of memory (Bank 1 in 

C-128) 

0039-3A Current BASIC line number 

007A7B Pointer: BASIC work pointer (CHRGET 

etc) 

NA Used by PRINT USING 

NA Pointer to item found by search 

003F-40 Current DATA line number 

0041- 42 Current DATA address 

0043-44 Vector. INPUT routine 

0045-46 Current BASIC variable name 

0047-4S Current BASIC variable address 



Mask used lor comparisons 
0049-4A Pointer: index variable lor FOR/NEXT 

Mask used for comparison 
004B-4C Pointer to operator table 

004 D Mask used for comparison 

004E-4F Pointer used for lunclion definition 



0050-51 Pointer: used for string operations 

Flag HELP or LIST 
0054-56 S4C (JMP) + address ot function 



0058-59 

0058-59 

005A-5B 

005C-0060 

005D-5E 

005F 



0060 

0061 

0062-65 

0066 

0069 

006A-006D 

006E 

006F 

0070 

0071-72 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

(see 9D) 

NA 

NA 

NA 

NA 



Graphic zero page storage 

COLSEL 0083 NA 

MULTCl 0084 NA 

MULTC2 0085 NA 

FG 0086 NA 

SCALEX 0087 NA 

SCALEY 0089 NA 

STOPNB 008B NA 

GRAPNT O08C-8D NA 

VTEMP1 008E NA 

VTEMP2 0O8F NA 

STATUS 0090 0090 



Multiple defined for INSTR 



Used lo define arrays (DIM) 
Pointer: used for block transfer 
Pointer: also used for block transfer 
Temporary FLP Accumulator (Accum) 
# decimal poini digits in conversions 
Flag: used lo test for decimal pt in 
strings 



Sign ol exponent 

FLP Accum #1. exponent 

FLP Accum #1. mantissa 

FLP Accum #1. sign 

FLP Accum #2: repeat as per FLPA #1 



Sign comparison. Accum #1:#2 

FLP Accum #1 rounding 

Pointer: cassette buffer 

Increment value for AUTO ($00 » off) 

Flag: 10K hi-res allocated 

Key chosen 

Leading zero counter 

Move sprite and sprite temporary 

Counter 

Key command length 

Temp lor indirect loads 

Descriptor lor disk error (DS$) 

BASIC pseudo stack pointer 

Flag: RUN/direct mode 

Status word for DOS parser 

Pointer to decimal point 



Current colour selected 



Scale factor m X 

Scale factor m Y 

Slop PAINT if not same colour 

Utility pointers 



ST = status 
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STKEY 


0091 


SVXT 


0092 


VERCK 


0093 


C3P0 


0094 


BSCjR 


0095 


SYNO 


0096 


XSAV 


0097 


LDTND 


009S 


DFLTN 


0099 


DFLTO 


009A 



PRTY 
DPSW 
MSGFLG 

PTR1 
TV 

PTR2 
T2* 

TIME 

PCNTR 

BSOUR1 

COUNT 

CNTDN 1 

BUFPNT 

INBIT 

BITCI 

RINONE 

RIDATA 

RIPITY 

SAL 

EAL 

CMPO 

TEMP 

TAPE1 

BITTS 

NXTBIT 

RODATA 

FNLEN 

LA 

SA 

FA 

FNADR 

ROPRTY 

CCCHAR - 

FSBLK 

MYCH 

DRIVE" 

CAS1 

STAL 

MEMUSS 

TMP2 

BA 

FNBANK 

RIBUF 
ROBUF 



009B 
009C 
009D 

009E 

009E 

0O9F 

009F 

O0A0-A2 

00A3 

O0A4 

00A5 

00A6 

00A7 

00A8 

00A9 

00 AA 

00AB 

OOAC-AD 

OOAE-AF 

0080 

COB1 

00B2 

00B4 

00B5 

00B6 

00B7 

00B8 

0089 

OOBA 

OOBB-BC 

OOBD 

OOBD 

OOBE 

OOBF 

OOCO 

O0C1-C2 

O0C3-C4 

O0C5 

O0C6 

00C7 

0QC8C9 
OOCA-CB 



0091 Flag: STOP and RVS keys 

0092 Tape timing constant 

0093 Flag : $00 = LOAD. SOI = VE RIFY 

0094 Flag: serial character awaiting output 

0095 Actual serial character waiting 

0096 Flag: end of data block from tape 

0097 Temporary store during input 
(lape/RS232) 

0098 tt open tiles/index into lile table 

0099 Default mpul device (0 = keyboardl 
009A Default output (CMD) device 

(3 = screen) 
009B ' Cassette parity during write 

009C Flag: byte read complete 

009D I/O messages: $00 -nil, S40 = errors. 

$80 -alt 
009E Cassette error pass 1 

Temp workspace 1 
009F Cassette error pass 2 

Temp workspace 2 
00A0-A2 Jiffy clock 

Cassette/serial temp 

Serial routine temp store 
00A5 Serial/cassette lemp store 

00A6 Cassette butler pointer 

00A7 RS232 receiver input bt storage 

00A8 RS232 receiver bit count in 

O0A9 RS232 receiver Hag for start bit check 

OOAA RS232 receiver byte buffer 

OOAB RS232 receiver party storage 

OOAC-AD Pointer lo tape buffer 

OOAE-AF Tape end address/end of program 

0030 Tape timing constant 

Address of tape buffer 

00B4 RS232 transmit bit count 

00B5 RS232 transmit next bit to send 

00B6 RS232 transmit byte buffer 

00B7 Number of characters in die name 

00B8 Current logical file 

00B9 Current secondary address 

OOBA Current device 

OOBB-BC Pointer lo file name 

OOBD RS232 transmit priority 

OOBD Output character 

OOBE # blocks left to read/write 

OOBF Temp to colleci byte 

OOCO Cassette moior control flag 

00C1-C2 I/O start address 

00C3-C4 Pointer for general use 

NA Tape read/write data 

NA Bank for current LOAD/SAVE/VERIFY 

NA Bank where current lile name (for 

FNADR) 

00F7-F8 RS232 mpul buffer addresses 

00F9-FA RS232 output buffer addresses 



Global screen editor variables 

KEYTAB OQCC-CD 00F5-00F6 Keyboard decode pointer (Bank 15 in 

C-128) 
IMPARM OOCE-CF NA PRIMM utility string pointer 

NDX 00D0 00C6 Number of characters in keyboard 

buffer 
KYNDX 00D1 NA Number ol programmed Chars waiting 

KEYIDX 00D2 NA Flag: index lo function key string 

SHFLAG 00D3 02BD Flag: shift key. $00- no shift 

SFDX 00D4 OOCB Copy ol LSTX for rollover 

LSTX 00D5 00C5 Last key pressed 

CRSW 0006 00 DO Input from screen/keyboard 

MODE 00D7 NA Flag: 40/80 columns ($00 = 40 

columns) 
GRAPHM 00D8 NA Flag: text/graphic mode 

CHAREN 00D9 NA Character base; $00 = ROM, 

$04 - RAM 
SEDSA OODADD NA Pointers MOVLIN routine (2 addresses) 

SEDT12 OODE-DF NA Pointers SAVPOS 

KEYVAR OODA-DF NA Programmable key variables 

LOCAL screen editor variables (40/80 change maps out) 

PNT O0E0-E1 00D1-D2 Pointer to screen line/cursor 

USER QOE2-E3 00F3-F4 Colour line pointer 

SCBOT 00E4-E? NA Window lower limit 

SCTO OOES NA Window upper limit 

SCLF 00E6 NA Window left margin 

SCRT 0OE7 NA Window right margin 

LSXP 00E8-E9 O0C9-CA Input cursor log (row, column) 

INDX OOEA 00C8 Current input line end 

TBLX OOEB 0OD6 Position of cursor on screen line 

PNTR 00 EC O0O3 Row where cursor lives 

LINES OOED NA Max number ol screen lines 



COLUMN 


OOEE 


NA 


Max number of screen columns 


DATAX 


OOEF 


00D7 


Current char lo print 


LSTCHR 


O0F0 


NA 


Previous Char printed (for ESC test) 


COLOR 


00F1 


0286 


Current colour to print 


TCOLOR 


0OF2 


NA 


Saved attribute lo print (INST/DEL) 


RVS 


O0F3 


00C7 


Flag: reverse mode on/off 


OTSW 


00F4 


00D4 


Flag, guote mode 


'NSRT 


00F5 


00D8 


Flag, insert mode (>0 = # inserts) ' 


INSFLG 


00F6 


NA 


Flag: auto-insert mode ($00 = off) 


LOCKS 


00F7 


NA 


Disable SHIFT/C = , CTRL-S 


SCROLL 


00F8 


NA 


Disable screen scroll, line linker 


BEEPER 


00F9 


NA 


Disable CTRL-G- (bell) 




00F9-FA 




UNUSED 
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FBUFFR 

XCNT 

DOSF1L 

DOSDS1 

DOSF1A 

DOSF2L 

DOSDS2 

DOSF2A 

DOSOFL 

OOSOFH 

DOSLA 

OOSFA 

DOSSA 

OOSRCL 

DOSBNK 

DOSDID 

DIDCHK 



0100-FF 

0T10 

0111 

0112 

0113-14 

0115 

0116 

0117-18 

01 19-1 A 

011B-1C 

011O 

011E 

011F 

0120 

0121 

0122-23 

0124 



PRINT USING work area (C-128 only) 



BNR 

ENR 

DOLR 

FLAG 

SWE 

LSGN 

UEXP 

VN 

CHSN 

VF 

NF 

POSP 

FESP 

ETOF 

CFORM 

SNO 

BLFD 

BEGFD 

LFOR 

ENDFD 



0125 
0126 
0127 
0128 
0129 
01 2A 
01 2B 
01 2C 
012D 
012E 
01 2F 
0130 
0131 
0132 
0133 
0134 
0135 
0136 
0137 
0138 
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BUF 


02OO-A0 


0200-58 


FETCH 


02A2-AE 


NA 


FETVEC 


02 AA 


NA 


STASH 


02AF-BD 


NA 


STAVEC 


02 B9 


NA 


CMPARE 


02BE-CC 


NA 


CMPVEC 


02C8 


NA 


JSRFAR 


02CD-E2 


NA 


JMPFAR 


02E3-F8 


NA 




02FC-FD 


NA 
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Processor stack area 

DOS loop counter 

DOS filename 1 length 

DOS disk drive 1 

DOS lilename 1 address 

DOS lilename 2 length 

DOS disk drive 2 

DOS filename 2 address 

BLOAD/BSAVE start address (SA) 

BSAVE ending address (EA) 

DOS logical address 

DOS physical address 

DOS secondary address 

DOS record ienglh (REL files) 

DOS Bank # 

DOS disk ID 

Disk ID check 



Pointer: beginning number 

Pointer: end number 

Flag: dollar 

Flag: comma 

Counter 

Sign exponent 

Pointer: exponent 

# digits belore decimal point 
Flag lustify 

» of positions before decimal point 

# ot positions after decimal point 
Fag plus or minus 

Rag: exponent 
Switch 

Character counter 
Sign number 
Ftag: blank/asterisk 
Pointer: beginning of field 
Length of lormat 
Pointer end of lield 



BASIC input buffer 
Bank PEEK subroutne 

Bank POKE subroutine 

Bank compare subroutine 

JSR to another Bank 
JMP lo another Bank 
Function execute hook 
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lERROR 


0300-01 


0300-01 


Vector to S4D3F/SE38B: output error 


message 








IMAIN 


0302-03 


0302-03 


Vector lo $4DC6'$A483: mam system 
loop 


ICRNCH 


0304-05 


0304-05 


Vector to S430D/3A57C: lokemze 
routine 


iQPLOP 


0306 07 


0306-07 


Vector to S5151/SA71A: LIST routine 


IGONE 


0308-09 


030809 


Vector to S4AA2/SA7E4 RUN routine 


IEVAL 


030A-0B 


O30A-0B 


Vector to J78DA/SAE86: eval routine 


IESCLK 


030C-0D 


NA 


Vector to S4321/NA escape token 
crunch 



IESCPR 


030E-0F 


MA 


IESCEX 


0310-11 


MA 




0312-13 


MA 


CINV 


0314-15 SAME 


CBINV 


0316-17 FOR 


NMINV 


0318-19 C64 


IOPEN 


031A-1B 




ICLOSE 


031C-1D 




ICHKIN 


031E-1F 




ICKOUT 


0320-21 




ICLRCH 


0322-23 




IBASIN 


0324-25 




IBSOUT 


0326-27 




ISTOP 


0328-29 




1GETIN 


032A-2B 




ICLALL 


032C-2D 




EXMON 


032E-2F T 


JA 


ILOAD 


0330-31 




ISAVE 


0332-33 




CTLVEC 


0334-35 r 


JA 


SHFVEC 


0336-37 r 


JA 


ESCVEC 


0338-39 t 


JA 


KEYVEC 


033A-3B r 


JA 


KEYCHK 


033C-3D f^ 


JA 


DECODE 


033E-49 t 


JA 


KEYD 


034A-53 C 


277-80 


TABMAP 


0354-SD t 


JA 


BITABL 


03SE-61 C 


JA 


LAT 


0362-6B C 


259-62 


FAT 


036C-75 C 


263-6C 


SAT 


0376-7F C 


26D-76 


CHRGET 


0380-9E C 


073-BA 


CHRGOT 


0386 C 


079 


ONUM 


0390 C 


07C 


Subroutines to fetch Irom Rf 


M Ban 


INSRAO 


039F r> 


A 


INSROI 


03AB r- 


A 


INDRA1 


03B7 r\ 


A 


INDRA2 


03C0 t> 


A 


ZERO 


03D2 l> 


A 


CUBNK 


03D5 r> 


A 


TMPDES 


03D6 f> 


A 


FNBNK 


03DA f. 


A 


SAVSIZ 


03DB S 


A 


BITS 


03DF K 


A 


SPTMP1 


03EO fi 


A 


SPTMP2 


03E1 1% 


A 


FG-BG 


03 E2 f» 


A 



FG-MC1 



03 E3 



Vector to S51CD/NA: escape loken 

print 

Vector to S4BA9/NA: execute vector 

Unused (SFFFF) 

Vector to SFA65/SEA31: IRQ 

Vector to SB003/SFE66: Break interrupt 

Vector to SFA40/SFE47: NMI interrupt 

From SFFCO to $EFBDf$F34A: OPEN 

routine 

From SFFC3 to $F18B/$F291: CLOSE 

routine 

From SFFC6 to SF106/SF20E: CHKIN 

routine 

From SFFC9 to SF14O3F2S0: 

CHKOUT routine 

From SFFCC 10 SF226/SF333: 

CLRCHN routine 

From SFFCF to $EF06/$F1S7: CHRIN 

routine 

From SFFD2 to 1EF79/SF1CA: 

CHROUT routine 

From SFFE1 to $F66E/$F6EO: STOP 

routine 

From SFFE4 to SEEEB/SF13E: GETIN 

routine 

From SFFE7 to IF222/SF32F CLALL 

routine 

Vector to SB006/NA: Monitor 

Vector to $F26C/$F4A5: LOAD 

Vector to SF54E/SF5ED SAVE 

Vector to SC7B9/NA: Print CTRL chars 

Vector to SCB05/NA: Print SHIFT chars 

Vector to SC9C1/NA: Print ESC chars 

Vector to SC5E1/NA: keyscan logic 

Vector to SC6AD/NA, store key 

Vector to SFA80/NA keyboard matrix 

tables 

IRQ Keyboard buffer 

Tab step bits 

l_ine wrap bits 

Logical tile table 

Device number table 

Secondary address table 

CHRGET subroutine 

CHRGOT entry 

Check for number 



Shared RAH fetch subroutine (S03A6) 

Shared ROM letch subroutine (S03B2) 

INDEX 1 indirect fetch 

INDEX2 indirect fetch 

Numeric constant tor BASIC 

Set by BANK cmd for SYS POKE 

PEEK 

Temp for INSTR 

Bank plr tor string-number conversion 

Temp work area lor SSHAPE 

Accum #1 overflow digit 

Temps for SPRSAV 

Packed lore/background colour 

nybbles 

Packed lore/multicolour 1 nybbles 



BITNUM 


0A15 


0298 


RS232 # bits to send 


BAUDOF 


0A16-17 


0299-9A 


RS232 baud rate lull bit lime 


RIDBE 


OAia 


029B 


RS232 receive pointer 


RIDBS 


0A19 


029C 


RS232 input pointer 


RODBS 


OAIA 


029D 


RS232 transmit pointer 


RODBE 


0A1B 


029E 


RS232 send pointer 


SERIAL 


0A1C 


NA 


Flag; fast serial internal/external 


TIMER 


0A1D-1F 


NA 


Decrementing |ilfy register 


XMA 


0A20 


0289 


Keyboard buffer size 


PAUSE 


0A21 


NA 


CTRL-S flag 


RPTFLG 


0A22 


028A 


Flag: key repeat ($80 -aH. $40-none) 


KOUNT 


0A23 


028B 


Delay between key repeals 


DELAY 


0A24 


028C 


Delay before key repeats 


LSTSHF 


0A25 


028E 


Delay between SHIFTzC - toggles 


BLNON 


0A26 


OOCF 


Cursor mode: $00 = blink. $FF = steady 


BLNSW 


0A27 


OOCC 


Cursor blink enable: $00 = flash 


BLNCT 


0A28 


OOCD 


Cursor blink counter 


GDBLN 


0A29 


OOCE 


Character under cursor 


GDCOL 


0A2A 


0287 


Cursor colour belore blink 


CURMOD 


0A2B 


NA 


VDC cursor mode {when enabled) 


VM1 


0A2C 


NA 


VIC text screen/char base pointer 


VM2 


0A2D 


NA 


VIC bit map base 


VM3 


0A2E 


NA 


VDC text screen base 


VM4 


0A2F 


NA 


VDC attributes base 


UNTMP 


OA30 


NA 




SAV80A 


0A31 


NA 


80 col routines work area 


SAV80B 


0A32 


NA 




SAV80C 


0A33 


NA 




SAV80D 


0A34 


NA 




CURCOL 


0A35 


NA 


VDC cursor colour before blink 


SPLIT 


0A36 


NA 


Split screen raster value 


FNADRX 


0A37 


NA 


Save X during Bank operaiions 


PALCNT 


OA38 


NA 


Jiffy adjustment for PAL systems 


MONITOR stores (C-128 only) 




XCNT 


0A8O 




Compare buffer 


HULP 


0AA0 






FORMAT 


0AAA 






LENGTH 


OAAB 






MSAL 


OAAC 






SXREG 


OAAF 






SYREG 


0AB0 






WRAP 


0AB1 






XSAVE 


0AB2 






DIRCTN 


0AB3 






TEMPM 


0AB4 






CURBNK 


0AC0 


NA 


Current lunclion key ROM bank 


PAT 


0AC1 


NA 


Physical address table 


TBUFFR 


0B00-BF 


033CFB 


Cassette buffer 


RS232I 


OCOO-ODFF 




RS232 I/O buffers 


RS2320 


0E00-0FFF 




System sprites 


PHKBUF 


1000-09 


NA 


Programmed key lengths 


PHKDEF 


100A-FF 


NA 


Programmed key lengths and 



DOSSTR 1100-1130 

Graphics variables 

1131-1138 

Line drawing variables 
1139-1148 

Angle routine variables 

1149-114F 



definitions 

DOS output buffer 



BANKO 



Circle drawing variables or general use variables 
or shape and move shape or graphics variables 



VICSCR 


0400-O7E7 
07F8-07FF 






0800-09FF 


NA 


Absolute Kernal Variables 




SYSVEC 


0AO0-OA01 


NA 


DEJAVU 


0A02 




PALNTS 


0A03 




INSTAT 


0A04 




MEMSTR 


0A05-06 


0281-82 


MEMSIZ 


OA07-08 


0283-84 


IRQTMP 


0A09-0A 


029FAO 


CASTON 


OAOB 


02A2 


KIKA26 


OAOC 


02A3 


STUPID 


OAOD 


02A4 


TIMOUT 


OAOE 


NA 


ENABL 


OAOF 


02A1 


M51CTR 


0A10 


0293 


M51CDR 


0A11 


0294 


M51AJB 


0A12-13 


0295-96 


RSSTAT 


0A14 


0297 



40-column screen memory 
Sprue identity area 
BASIC pseudo slack 



Vector: BASIC restart 

Kernal warm/cold start status vector 

PAL/NTSC system flag 

Bottom of memory pointer 
Top of memory pointer 
Save for IRQ during tape 
TOD sense during tape 
Tape read temp 
Tape read IRQ indicator 
Fast serial timeout flag 
RS232 enables 
RS232 control register 
RS232 command register 
RS232 user baud rale 
RS232 status register 





1150-116F 




ADRAY1 


117A-117B 


0003-4 


ADRAY2 


117C-117D 


0005-6 


LPEN 


11E9-11EA 


NA 


OLDLtN 


1200-01 


003B-3C 


OLDTXT 


1202-03 


003D-3E 


PUCHRS 


1204-1207 


NA 


ERRNUM 


1208 


NA 


ERRUN 


1209- 120 A 


NA 


TRAPNO 


120B-120C 


NA 


TMPTRP 


120D 


NA 


ERRTXT 


120E 




TEXTTP 


1210-11 




MAXMMO 


1212-13 




TMPTXT 


1214-15 




USRPOK 


1218-1A 


0310-12 


RNDX 


121B-1F 


008B-8F 


Music Stores 






1220-1271 




Interrupt Stores 






1276-1280 





Vector to FLP-tixed routine (S84B4) 

Vector to Fixed-FLP routine (S793C) 

Light pen X,Y values 

Previous BASIC line number 

Pointer- BASIC statement lor CONT 

PRINT USING chars ( ..$) 

ER - Error type 

EL = Error line number (FFFF No 

error) 

Line to go to on error {FFxx none) 

Hold trap # temp 

End ol BASIC (Bank 0) 
BASIC program limit $FF00 
Used by DO loop 
USR program jump 
RND seed value 
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Sound Stores 






OROP 


4CB6 


AFE6 


Perform OR 




1 2B1 -1 2FF 






ANDOP 


4C89 


AFE9 


Perform AND 


START 


1C01 


0801 


Normal start ol BASIC ten! 


COREL 


4CB6 


B016IS/R) 


Perform COMPARE 


BASIC 










4D2A 


C474 


Punt "READY" 




2000-3FFF 




Screen memory (hi res) 


ERROR 


4D3F 
4DAF 
4DC6 




Output error ($0300) 

BREAK 

Ready for BASIC ($0302) 




4000-FBFF 




RAM memory (hi-res) 


MAIN 


A480 










HOHUM 


4DCD 




Ready ($AFA5) 


BANK 1 






MAIN1 
LNKPRG 


4DE2 
4F4F 


A49C 
A533 


Handle new line 
Recham lines ($AF87) 










INLIN 


4F93 
4FAA 


A560 


Get BASIC line 
Searcn BASIC slack 


0400-FBFF 






BASIC variables, arrays, strings 




4FFE 
5017 
5047 




Insert in stack 

Check if room for more 

Copy stack pointer 


BANK 14 








5050 
5059 




Set stack pointer 
Delete from stack 










FNDLIN 


=064 


A613 


Fma BASIC line (SAF8D) 










LINGET 


50 A0 


A96B 


Get FLP number (SAF9F) 










LIST 


50E2 


A69C 


Perform LIST 


Sa me as Ban K 1 5, except: 






QPLOP 


5151 


A6C9 


LIST subroutine (S0306) 




DOODDFFF 




Character generator ROM (same as 


ESCPR 


51 CD 




Escape token print (S030E) 








C-64) 


NEW 


51 D6 


A642 


Perform NEW (SAF84) 










RUNC 


51 F3 


A659 


Get ready to RUN (SAF7E) 










CLEAR 


51 F8 


A65E 


Perform CLR (SAF81) 


BANK 15 






LDCLR 
STXPT 


5238 
5254 


A677 
A68E 


Reset stack 

Back up text pointer 










RETURN 


5262 


A8D2 


Perform RETURN 










DATA 


52BF 


A8F8 


Perform DATA/BEND 




4000-CFFF 


AO00CO00 


BASIC ROM 


REM 


529D 


A93B 


Perform REM 




DO00-DO30 




40-co! video chip 8564 (Same as 64) 


DATAN 


52A2 


A906 


Scan to next statement 




D400-D41C 




SID sound chip 6581 (Same as 64) 


REMN 


52A5 


A909 


Scan to next line 




D500-D50A 


NA 


MMU 8722 memory setup registers 


IF 


52C5 


A928 


Perform IF 




D600-D601 


NA 


80-column CRTC 




5320 


NA 


Search/skip BEGIN/BEND 




D800-D8E7 




Colour nybbles (Same as 64) 




537C 


NA 


Skip string constant 




DC00-DC0F 




CIA1 6526 (IRQ) (Same as 64) 




5391 


NA 


Perform ELSE 




DDOC-DDOF 




CIA2 6526 (NMI) (Same as 64) 


ON GOTO 


53A3 


A94B 


Perforin ON 




DFO0-DF0A 


NA 


DMA controller 


LET 


53C6 


A9A5 


Perform LET 




EOOO-FEFF 


E000FFFF 


Kernal ROM 




S4F6 




Check string location 




FF05-FFFF 


FF81-FFFF 


ROM. transfer, jump table 


PRtNTN 


553A 


AA80 


Perform PRINT# 










CMD 


5540 


AA86 


Perform CMD 










PRINT 


555A 


AAAO 


Perform PRINT 


BASIC 7.0/2.0 ROM Routines 


GET 


5600 
5612 


AB7B 


Print format character 
Perform GET 










INPUTN 


5648 


ABA5 


Perform INPUT* 










INPUT 


5662 


ABBF 


Perform INPUT 


Label 


B7.0 


B2.0 


Description 


OINLIN 


569C 


ABBF 


Print ■'?" and take input 










READ 


56A9 


AC06 


Perform READ 










NEXT 


57F4 


AD1E 


Perform NEXT 


BCOLD 


4000 


A000 


J MP COLD START ($4023) Start ol 


DIM 


587B 


B08I 


Perform DIM 








Basic ROMs 


SYS 


58B5 


E12A 


Perform SYS 




4003 


A003 


JMP WARM START (S4009) 




5SB4 


NA 


Perform IRON 




4006 




JMP SA84D IRQ S/R 




58B7 


NA 


Perform TROFF 


BASSFT 


4009 


E37B 


Warm start routine 




58BD 


NA 


Perform RREG 


INIT 


4023 


E394 


Cold start routine 




5975 


NA 


Perform AUTO 


INITCZ 


4045 


E3BF 


Initialize BASIC 




5986 


NA 


Perform HELP 




4112 


NA 


Beli 




59AC 


NA 


Place help marker 




417A 


NA 


Set preconfiguration registers 


GOSUB 


59CF 


A883 


Perform GOSUB 




418D 


NA 


Set up sprite movement tables 


GOTO 


59DB 


A8A0 


Perform GOTO 


INITMS 


4193 


E422 


Print "COMMODORE Basic 7.0. " 




5A1D 




Push return address to stack 


INiTV 


4251 


E453 


Set BASIC links initialize vectors 




5A3D 




Perform GO 


INITAT 


4279 


E3A2 


CHRGET routine to move to S0380 


CONT 


5A60 


A857 


Perform CONT 




42CE 


NA 


Indirect letches: Irom ($S0) Bank 


RUN 


5A9B 


AB71 


Perform RUN (SAF7B) 




42D3 




from ($3F) Bank 1 


NEWSTT 


5AA6 




Get next statement (SAF99) 




42D8 




Irom ($52) Bank 1 


RESTRE 


SACA 


A81D 


Perform RESTORE (AF9C) 




42DD 




Irom ($SC) Bank 


SETEXC 


5AE1 








42E2 




Irom ($5C) Bank 1 




5AF8 


NA 


Perform RENUMBER 




42E7 




Irom ($66) Bank 1 




5BAE 


NA 


RENUMBER (continued) 




42EC 




trorn ($61) Bank 




5BFB 


NA 


Scan program 




42F1 




from ($70) Bank 




5D19 


NA 


Change line number 




42F6 




from ($70) Bank 1 




5D68 


NA 


Find RENUMBER Start 




42FB 




from ($50) Bank 1 




5D75 


NA 


Line count 




43O0 




from ($61) Bank 1 




5D89 


MA 


RENUMBER increment S/R 




4305 




from ($24) Bank 




5D99 


NA 


Scan forwards 


CRUNCH 


430A 




Crunch tokens ($AF8A) 




5DA7 


NA 


Block move 


CRUNCH 


430D 


A57C 


Crunch tokens ($0304) 




5DC6 


NA 


Move block down 


ESCLK 


4321 




Escape token crunch ($030C) 




5DDF 


NA 


Move block up 




43E2 




Check it keyword found 


FOR 


5DF9 


A742 


Perform FOR 


RESLST 


4417 


A093 


Table ol Keywords 




5E87 


NA 


Perform DELETE 


OPLiST 


46FD 


A140 


Keyword vectors 




5EFB 


NA 


Get line range 


OPTAB 


4828 




Operator vectors (SAF6F) 




5F34 


NA 


Perform PUDEF 


ERRTAB 


4B4B 


A19E 


Table of error messages 




5F4D 


NA 


Perform TRAP 


ERROR 


4A82 


A437 


Find message (A) start of error msg 




5F62 


NA 


Perform RESUME 


GONE 


4AA2 


A7E4 


Read and execute next statement 




5FB7 


NA 


Restore TRAP pointer 








($0306) 




5FD8 


NA 


Bad syntax — exit 


NEWSTT 


4AF6 




Set up statement tor execution ($AF90) 




5FDB 


NA 


"CANT RESUME" 


CONT 


4B34 
4B3F 


A857 
NA 


Update CONT pointer 
Execute/trace statement 




5FE0 


NA 


Perform DO 


ESCEX 


4BA9 




Skip statement ($0310) 




6039 


NA 


Perform EXIT 


STOP 


4BCa 


A82C 


Perform STOP 




608A 


NA 


Perform LOOP 


END 


4 BCD 


A82F 


Perform END 




60S4 


NA 


"LOOP NOT FOUND" 


GETFMN 


4BF7 


B3E1 


Set up FN reference 




6087 


NA 


"LOOP WITHOUT DO" 



24 TPUG Magazine 





60E1 


NA 


Oelme programmable key 




83E1 


NA 


Perform XOR 




61 OA 


NA 


Perform KEY 




B407 


NA 


Perform RWINOOW 




61 AS 


NA 


Perform PAINT 


RND 


8437 


E097 


Perform RND 




62 B7 


NA 


Perform BOX 


RND0 




E094 






642B 


NA 


Perform SSHAPE 


QSETNfi 




E0BE 






658D 


NA 


Perform GSHAPE 


RND1 




E0D3 






668E 


NA 


Perform CIRCLE 


RNDRNG 




E0E3 




CIRSUB 


6750 


NA 


Draw circle ($AF78) 




84A7 




Evaluate fixed number 




6797 


NA 


Perform DRAW 


AYINT 


84B4 




FLP-fixed signed (SAF00) 




67D7 


NA 


Perform CHAR 


POS 


84C9 


B39E 


Perform POS 




6955 


NA 


Perform LOCATE 


ERRDIR 


84D9 


B3A6 


Check if direct mode 




6960 


NA 


Perform SCALE 




840 □ 




"ILLEGAL DIRECT" 




69E2 


NA 


Perlorm COLOR 




84 E0 




"UNOEFD FUNCTION" 




6A5C 


NA 


Store current colours 




84E5 




Set up 16-bit fixed-FLP 




6A79 


NA 


Perform SCNCLR 




84F5 




"DIRECT MODE ONLY" 




6B06 


NA 


Fill memory page 


DEF 


84FA 


B3B3 


Perlorm DEF 




6B17 


NA 


Set screen colour 


GETFNM 


8528 


B3E1 


Check FN syntax 




6B30 


NA 


Clear hi-res screen 


FNDORE 


853B 


B3F4 


Perform FN 




68SA 


NA 


Perform GRAPHIC 


STRD 


65AE 


B465 


Perform STRS 




68C9 


NA 


Perform BANK 


CHRD 


S5BF 


B6EC 


Perform CHRS 




6B07 


NA 


Perform SLEEP 


LEFD 


85D6 


B700 


Perform LEFTS 




6C2D 


NA 


Perform WAIT 


RIGHTD 


860A 


B72D 


Perform RIGHTS 




6C4F 


NA 


Perform SPRITE 


MIDD 


861C 


B737 


Perform MIDI 




6CC6 


NA 


Perform MOVSPR 


PREAM 


864D 


B761 


Set up string parameters 




6DE1 


NA 


Perform PLAY 


LEN 


8668 


B77C 


Perform LEN 




6E02 


NA 


PLAY subroutine 


LEN1 


866E 


B782 


Exit from string mode 




6EB2 


NA 


Set SID sound 


ASC 


8677 


B78B 


Perform ASC 




6EFD 


NA 


PLAY error 




8688 




Calculate string vector 




6F03 


NA 


Dotted note 




869A 




Set up string 




6F1E 


NA 


Nole A-G 


MOVINS 


B74E 


B67A 


Move string to store 




6F69 


NA 


Sharp 


FRESTR 


877B 


B6A3 


Discard unwanted string 




6F6C 


NA 


Flat 


FRETMS 


87E0 


B6DB 


Clean descriptor stack 




6F78 


NA 


Rest 




87F1 




Gel integer byte 




6F07 


NA 


Perlorm TEMPO 


WAIT 


8803 


B82D 


Get parameters for POKEWAIT 




7046 


NA 


Perlorm FILTER 


GETADR 


8815 


B7F7 


Convert FLP to an address (SAFOC) 




70C1 


NA 


Perform ENVELOPE 


FSUB 


882E 


B853 


Perform SUBTRACT (JAF12) 




7164 


NA 


Perlorm COLLISION 


FSUBT 


8831 




Arg-FLP Accum #1 (SAF1S) 




7190 


NA 


Perform SPRCOLOR 


FADD 


8845 


B867 


Add memory ($AF18) 




71 B6 


NA 


Perform WIDTH 


FADDT 


8848 


B86F 


Perform ADD (SAF1B) 




71C5 


NA 


Perform VOL 




8917 




Adjust FLP Accum * 1 




71 EC 


NA 


Perform SOUND 




694E 




Round up FLP Accum * 1 




72CC 


NA 


Perform WINDOW 


OVERR 


895D 


B97E 


"OVERFLOW" 




7335 


NA 


Perform BOOT 


LOG 


89CA 


B9EA 


Perform LOG (SAF2A) 




7372 


NA 


Perform SPROEF 




8A0E 


B849 


Add 0.5 




76EC 


NA 


Perform SPRSAV 


FMULT 


8A24 


BA28 


Multiply by memory (SAF1E) 




77B3 


NA 


Perform FAST 


FMULTT 


8A27 


BA30 


Perform MULTIPLY (SAF21) 




77C4 


NA 


Perform SLOW 


ROMUPK 


8A89 


BA59 


Unpack ROM lo FLP Accum #2 


FRMNUM 


77D7 


AD8A 


Type match check 








(SAF5C) 




77E7 




TYPE MISMATCH MISMATCH'' 


CONUPK 


8AB4 


BA8C 


Unpack RAM lo FLP Accum #2 




77EA 




"FORMULA TOO COMPLEX" 








(SAF5A) 


FRMEVL 


77EF 


AE83 


Evaluate expression (SAF96) 


MULOIV 


BAE3 


BAB7 


Adjust FLP Accum #1/#2 


EVAL 


78D7 




Evaluate item (SAF93) 


MUL10 


8B17 


BAE2 


Multiply by 10 


EVAL1 


76DA 




Evaluate item (S030A) 




8333 




"DIVISION BY ZERO 


GIVAYF 


793C 




Convert lixed-FLP (SAF03) 


DIV10 


8B38 


BAFE 


Divide by 10 


PAF1CHK 


7950 


AEF1 


Eval within parentheses 


FDIV 


8B49 


BB07 


Divide into memory (SAF24) 


CHKCOM 


795C 


AEFD 


Check lor comma 


FDIVT 


BB4C 


BB12 


Perform DIVIDE (SAF27) 


SYNERR 


796C 


AF08 


Syntax error 


MOVFM 


8BD4 


BBA2 


Unpack ROM to FLP Accum *f1 


ISVAR 


7978 


AF28 


Search lor variable 








($AF63) 


MOVFRM 


7A85 




Unpack RAM lo FLP Accum #1 


MOV2F 


8BF9 


BB27 


Pack FLP Accum #1 to $5E 








(SAF60) 


MOV1F 


8BFC 


BBCA 


Pack FLP Accum #1 to $59 




7AAF 




Locate variable 


MOVMF 


8C00 


BBD0 


Pack FLP Accum #1 to RAM (SAF66) 


DOREL 




B016 


Check variable 


MOVFA 


8C28 


BBFC 


FLP Accum #2 to FLP Accum #1 


NUMREL 




B01B 


Check it numeric 








(SAF69J 


STREL 


7B3C 


B02E 


Check it string 


MOVAF 


8C38 


BCOC 


FLP Accum #1 to FLP Accum #2 


NOTFNS 


7B46 


B11D 


Create new variable 








(SAF6C) 


NOTFDD 


7CAB 


B261 


Se! up array 


ROUND 


BC47 


BC1B 


Round FLP Accum #1 ($AF4B) 


BSERR 


7D25 


B245 


■'BAD SUBSCRIPT" 


SIGN 


8C57 


BC39 


Get sign (SAF51) 




7D28 




"ILLEGAL QUANTITY" 


SGN 


BC65 


BC39 


Perform SGN 


UMULT 


7E3E 


B34C 


Calculate array size 


ACTOFC 




BC3C 






7E71 




Array pointer S/Ft 


INTOFC 
FLOATC 


8C75 


BC44 


Convert fixed to FLP (SAFOF) 


FRE 
VAL 


8000 
804A 


B37D 


Perform FRE 


ABS 


8C84 


BC58 


Perform ABS (SAF4E) 


B7AD 


Perform VAL 


FCOMP 


8C87 


BC5B 


Compare FLP Accum #1 lo memory 


VAL1 


8052 




Converl ASCII siring 10 FLP (SAF09) 








(SAF54) 




8076 


NA 


Perform DEC 


QINT 


8CC7 


BC9B 


Convert FLP to fixed 


PEEK 

POKE 


80C5 


B80D 


Perform PEEK 


INT 


8CFB 


BCCC 


Perform INT (SAF2D) 


80E5 


B824 


Perform POKE 


FIN 


8D22 


BCF3 


Move string to FLP Accum #1 




8QF6 


NA 


Perform ERRS 




AADD 


BD7E 






8139 
8142 


NA 
NA 


Swap X with Y 
Perform HEXS 


STCONS 


8DB0 


BDB3 


Get ASCII digit 




816B 


NA 


Convert byte to hex 


INPRT 


8E26 


BDC2 


"IN" 




8182 
81 8C 


NA 
NA 


Perform RGR 

Get graphics mode 


LINPRT 
FOUT 


8E32 
8E42 


BDCD 
BDDD 


Print integer 

Convert FLP to ASCII (SAF06) 




81 9B 


NA 


Perform RCLR 


FOUTIM 




BE68 






8203 
B24D 
B2AE 


NA 
NA 
NA 


Perform JOY 
Perform POT 


TICONS 

SQR 


8FB7 


BF11 
BF71 


Perform SQR (SAF30) 




Perform PEN 


FPWR 


8FBE 


B"B 


Raise to power (SAF36J 




82FA 


NA 


Perform POINTER 


NEGOT 




BFB4 






831E 
837C 
8397 


NA 
NA 
NA 


Perform RSPRITE 
Perform BUMP 
Perlorm RSPOS 


EXCONS 

FPWRT 

NEGOP 


8FC1 
8FFA 


BFBF 
BFB4 


Perform exponent ($AF39) 

Perform MINUS/SUBTRACT (SAF33) 
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EXP 


9033 


BFED 


POLYX 




E059 


RMULC 




EOBD 


EADDC 




E092 


SAVET . 


9112 


E156 


VERFYT 


9129 


E165 


LOADT 


91 2C 


E168 


OPENT 


918D 


E1BE 


CLOSET 


919A 


E1C7 


SLPARA 


9299 


E1D4 


COMBYT 




E200 


CMMERR 




E20E 


GARBA2 


92EA 




COS 


9409 


E264 


SIN 


9410 


E26B 


TAN 


9459 


E2B4 


ATN 


94 B3 


E30E 




9520 


NA 




99C1 


NA 




9B0C 


NA 


DRAWLN 


9B30 


NA 


GPLOT 


9BFB 


NA 




9C70 


NA 




9E2F 


NA 




A07E 


NA 




A110 


NA 




A134 


NA 




A157 


NA 




At6F 


NA 




A18C 


NA 




A1A4 


NA 




A1A7 


NA 




A1C8 


NA 




A218 


NA 




A267 


NA 




A2A1 


NA 




A2D7 


NA 




A322 


NA 




A32F 


NA 




A346 


NA 




A362 


NA 




A36E 


NA 




A37C 


NA 




A3BF 


NA 




A5E7 


NA 




A5EA 


NA 




A5EO 


NA 




A7E1 


NA 




A845 


NA 




A84D 




BASIC JUMP TABLE (C12B only) 




AF00 






AF03 






AF06 






AF09 






AFOC 






AFOF 




MATH FUNCTIONS {C-12B only) 




AF12 






AF15 






AF18 






AF1B 






AF1E 






AF21 






AF24 






AF27 






AF2A 






AF2D 






AF30 






AF33 






AF36 






AF39 






AF3C 






AF3F 






AF42 






AF45 






AF4B 






AF4B 






AF4E 






AF51 






AF54 






AF57 




MOVEMENT (C-12B only) 






AF5A 





AF5D 



Perform EXP (SAF3C) 



Perform SAVE 

Perform VERIFY 

Perform LOAD 

Perform OPEN 

Perform CLOSE 

Sei aside room lor siring 

Check lor comma and gel byte 

Check for last comma 

Garbage collection (SAFA2) 

Perform COS (EAF3F) 

Perform SIN (SAF42) 

Perform TAN (SAF45) 

Perform ATN (SAF48| 

PRINT USING S/R 

Perform INSTR 

Perform RDOT 

Draw a line f$AF72) 

Plot a point (SAF75) 

Set a hi. res colour cell 

Parse GRAPHIC command 

Perform CATALOG/DIRECTORY 
Perform DOPEN 
Perform APPEND 
Find next secondary address 
Perform OCLOSE 
Perform DSAVE 
Perform DVERIFY 
Perform DLOAD 
Perform BSAVE 
Perform BLOAD 
Perform HEADER 
Perform SCRATCH 
Perform RECORD 
Perform DCLEAR 
Perform COLLECT 
Perform COPY 
Perform CONCAT 
Perform RENAME 
Perform BACKUP (joke) 
Parse DOS commands 
"MISSING FILE NAME" 
'ILLEGAL DEVICE NUMBER- 
STRING TOO LONG" 
"ARE YOU SURE-'" 
Set Bank 15 
IRQ S/R 



JMP S84B4. convert FLP to integer 

JMP S793C convert integer to FLP 

JMP S8E42 convert FLP to ASCII 

string 

JMP $8052 convert ASCII string to 

FLP 

JMP SB815 convert FLP to an address 

JMP S8C75: convert adcress 10 FLP 



JMP SB82E Mem-FLP Accum 
JMP 5B831 Arg-FLP Accum 
JMP SBS45 Mem + FLP Accum 
JMP $8848 Arg + FLP Accum 
JMP $8A24 Mem' FLP Accum 
JMP $8A27 Arg'FLP Accum 
JMP S8B49 Mem/FLP Accum 
JMP S8B4C Arg/FLP Accum 
JMP S89CA Log FLP Accum 
JMP S8CFB INT FLP Accum 
JMP S8FB7 SCR FLP Accum 
JMP S8FFA Negate FLP Accum 
JMP $8FBE Raise Arg to Mem power 
JMP $SFC1 Raise Arg to FLPA power 
JMP $9033 Calc EXP of FLP Accum 
JMP $9409 Calc COS of FLP Accum 
JMP $9410 Calc SIN ol FLP Accum 
JMP $9459 Calc TAN ol FLP Accum 
JMP S94B3 Calc ATN ol FLP Accum 
JMP SBC47 Round FLP Accum 
JMP S6C84 A9S o! FLP Accum 
JMP $8C57 Test sign of FLP Accum 
JMP $BCB7 Compare FLP Accum with 
Mem 
JMP $8437 Make random FLP number 



JMP SBAB4 Move RAM Mem to Arg 
JMP S8A89 Move ROM Mem to Arg 



AF60 
AFB3 



AF66 




AF69 




AF6C 




BASIC ROUTINES {C-12B only) 


AF6F 




AF72 




AF75 




AF7B 




AF7B 




AF7E 




AF81 




AF84 




AF87 




AF8A 




AF8D 




AF90 




AF93 




AF96 




AF99 




AF9C 




AF9F 




AFA2 




AFA5 




MONITR B000 


NA 


MONBRK BOOS 


NA 


MONCMD B006 


NA 


B050 


NA 


B08B 


NA 


B0BC 


NA 


B0E3 


NA 


B11A 


NA 


B12A 


NA 


B152 


NA 


B194 


NA 


B1AB 


NA 


B1D6 


NA 


B1DF 


NA 


B231 


NA 


B234 


NA 


B2CE 


NA 


B337 


NA 


B3DB 


NA 


B406 


NA 


B58B 


NA 


B599 


NA 


B5D4 


NA 


B659 


NA 


B7AS 


NA 


B7CE 


NA 


B8D2 


NA 


B8E9 


NA 


B901 


NA 


B950 


NA 


B9B1 


NA 


BA90 





EDITOR JUMP TABLE 

COOO 



CINT 



IRO 

KBGET 



C003 

C006 
C009 

COOC 
CO0F 

C012 

C015 
C01B 

C01B 
C01E 
C021 

C024 
C027 
C02A 

C02D 
C07B 
C15C 
C17C 

c ■■:■■■ 

C234 



FF5B 



E518 



E5B4 



JMP $7A85 Move RAM Mem lo FLP 

Accum 

JMP $8BD4 Move ROM Mem to FLP 

Accum 

JMP $8C00 Move FLP Accum to Mem 

JMP $8C2B Move Arg lo FLP Accum 

JMP $8C36 Move FLP Accum to Arg 

JMP $4828 Operator tables 
JMP $9B30 Draw a I ne 
JMP S9BFB Plot a point 
JMP S6750 Draw a circle 
JMP S5A9B RUN 
JMPS51F3 RUNC 
JMP $51 F8 CLEAR 
JMP$51D6NEW 
JMP $4F4F LNKPRG 
JMP $430A CRUNCH 
JMP $5054 FNDLIN 
JMP $4AF6 NEWSTT 
JMP S78D7 EVAL 
JMP S77EF FRMEVL 
JMP S5AA6 NEWSTT 
JMP S5A81 SETEXC 
JMP S50A0 LINGET 
JMP S92EA GAR BAG 
JMP S4DCD READY 

Perform MONITOR 

"Break" entry ($0316) 

Command parser (S032E) 

R cmd: registers 

Test command 

Error found 

X cmd: exit 

Read memory from Bank 

Write memory from Bank 

M cmd:: memory 

. cmd: modify registers 

> cmd: modily memory 

G cmd: go 

J cmd: jump 

C cmd: compare 

T cmd: transfer 

H cmd: hunt 

LSV onds: LOAD.SAVE.VERIFY ; 

F cmd fill 

A cmd: assemble 

Test next opcode 

D cmd- disassemble 

Print instruction 

Classify opcode 

Input parameter 

Get value 

Convert byte to 2 ASCII chars 

Gel character 

Cop/ addresses 

Increment pointer 

$ + &% cmd conversions 

(at) cmd. wedge 

From $FF81 JMP SC07B: mil 

editor/screen 

JMP $CC34 show char in A colour in 

.X 

JMP $C234 get key (IRO) into .A 

JMP SC29B: get char from screen into 

A 

JMP SC72D: print char in A 

From SFFED JMP SCC5B get screen 

org in X/.Y 

From $FF9F. JMP SC55D scan 

keyboard 

JMP$C651. repeat key 

From SFFF0: JMP SCC6A. readfset 

crsr in XI Y 

JMP SCD57: move 8563 cursor S/R 

JMP SC9C1: perform ESC (char in A) 

JMP SCCA2: redefine programmable 

key 

JMP $C194. IROenlry 

JMP $CE0C: initialize 80 col chars 

JMP $CD2E- 40/80 column location 

swap 

JMP SCAlO: set window corners 

Initialize screen ($FF81,$C000) 

Sel up new line 

80 column colour 

IRO entry ($C024) 

Get a key ($C006) 
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KBINP 




E5CA 




SCNOK 


E4E0 


EDB9 


KSINP 




E632 




CIOUTK 


E503 


EODD 


SC1NF 


C29B 


E63A 


Input Irom screen (SC009; 


UNTLKK 


E515 


EFEF 


TGLQT 


C2FF 


E684 


Check for quotes 








SCPUT 




E691 




UNLSNK 


ES26 


EDFE 


SCPNT 




E716 












C30C 




Wrap up screen prim 


ACPTHK 




EE13 


IRQK 


C55D 


EA87 


Scan keyboard (SC012) 


NMICNT 




EEBB 


KEYVEC 


C5E1 




Keyboard read (S033A) 




E5C3 


NA 


REPEAT 


C651 




Get key and repeat (IC0 15) 




E5D6 


NA 


KEYCHK 


CBAO 




Store key ($033C) 




E5FB 


NA 


KBDTBL 


C6AD 


EB81 


Keyboard decode tables 


RSWRT 


E5FF 


EF06 


PRINT 


C72D 




Print to screen (SCOOC) 


RSBLD 


E69D 


EF59 




C77D 


NA 


ESC-0 (escape) 




E795 


F04D 




C7B9 




Print CTRL character (S0334) 




E7CE 


F086 




CS05 




Print SHIR character ($0336) 




E7EC 






C854 




CHR£(29): cursor right 




E805 






CB5A 




CHR$(17) cursor down 




E878 






CB80 




CHR$(14) lent 




E8A9 






C8A6 




CHR$(11). lock 


THE ADR 


E8D0 


F72C 




C8AC 




CHR$(12): unlock 




E919 


F76A 




C8B3 




CHR$(19) home 




E960 


F7D0 




CBC2 




CHH$(1B) rvs 




E987 


F7D7 




C8C7 


NA 


CHFt$(2) underline on 




E99A 


F7EA 




C8CE 


NA 


CHR$(130): underline Oft 




E9BE 


F80O 




C8D5 


NA 


CHRS(15): Hash on 




ESC8 


F817 




C8DC 


NA 


CHR$(143); Hash off 




E9DF 


FS2E 




C8E3 




Open screen line 




E9E9 






C91B 




CHR$(20): delete 




E9F2 


F841 




C94F 


NA 


CHR$(9): tab 




EA18 


F864 




C961 


NA 


CHR$<24): lab switch 




EA26 


FB7S 




C980 


NA 


ESC Z clear all labs 




EA8F 


F8D0 




C983 


NA 


ESC Y set default tabs 




EAA1 


F8E2 




C98E 


NA 


CHR$(7): bell 




EAEB 






C9B1 




CHR$(10). linefeed 




EC1F 




ESCAPE 


C9C1 


NA 


Test ESC sequence ($CQ1E,S0338) 




ED51 






CA14 


NA 


ESC T set window top 




EDSA 






CA16 


NA 


ESC B. set window bottom 




ED69 




WINDOW 


CA1B 


NA 


Set window (SC02D) 




ED8B 






CA3D 


NA 


ESC 1 insert line 




ED90 






CA52 


NA 


ESC D delete line 




EE2E 






CA76 


NA 


ESC 0: erase to line end 




EE9B 






CA6B 


NA 


ESC P: erase to line star! 




EEA8 






CA9F 


NA 


ESC (all clear rest of screen 




EEB0 






CABC 


NA 


ESC V scroll up 




EEDO 






CACA 


NA 


ESC W: scroll down 


NGETIN 


EEEB 


F13E 




CAE2 


NA 


ESC L- scroll on 










CAE5 


NA 


ESC M scroll oft 


NBASIN 


EF06 


F157 




CAEA 


NA 


ESC C cancel auto-insert 










CAED 


NA 


ESC A. auto insert 




EF48 






CAF2 


NA 


ESC S block cursor 


NBSOUT 


EF79 


F1CA 




CAFE 


NA 


ESC U: underline Cursor 










CBOB 


NA 


ESC E: non-Hashing cursor 


NOPEN 


EFBD 


F34A 




CB21 


NA 


ESC F. flashing cursor 










CB37 


NA 


ESC G: bell enable 










CB3A 


NA 


ESC H: bell disable 










CB3F 


NA 


ESC R: screen reverse 


NCHKIN 


F106 


F20E 




CB48 


NA 


ESC N: screen normal 










CB52 


NA 


ESC K: go to end of line 


NCKOUT 


F14C 


F250 




CBB1 


NA 


ESC J: go to start of line 










CC34 


E716 


Send character to screen (SC003) 


NCLOSE 


F18B 


F291 


3CRORG 


CC5B 


E505 


Read row/column (SCOOF) 




F202 




PLOT 


CC6A 


E50A 


Read/set cursor ($C018) 




F212 




KEYSET 


CCA2 


NA 


Define function key (SC021) 


NCLALL 


F222 


F32F 


SWAPPfl 


CD2E 


NA 


ESC X: switch 40/80 screen (SC02A) 








CURSOR 


CD57 
CDCA 


NA 
NA 


Posilior 60-col cursor (SC01B) 
Set Register 31 


NCLRCH 


F226 


F333 




CDCC 


NA 


Set scrBen register 


CLRIO 


F23D 


NA 




CDDB 


NA 


Read Register 31 


LOADSP 


F265 


F49E 




CDDA 


NA 


Read screen register 










CDE6 


NA 


Set CRT to screen address 


LOAD 


F26C 


F4A5 




COF9 


NA 


Set CRT to colour address 




F27B 


F4BF 


INIT80 


CEOC 
EOOO 


NA 
Reset Sin 


Initialize 80 columns (SC027) 




F32A 
F3A1 
F4BA 


F539 


RESTOR 


E056 


FD15 


From SFF8A reset standard I/O 
devices 




F4CS 
F503 




VECTOR 


E05B 


FD1A 


From SFFBD. set/store I/O vectors 




F50F 




RAMTAS 


E093 


FD50 


From SFF87 test RAM 




F533 






EOCD 


NA 


Transfer all Banks 


SAVEP 


F53E 


F5DD 


IOINIT 


E109 


FDA3 


From SFF84 initialize I/O 










E1F0 


NA 


Search tor Boot ROM 


SAVE 


FS4E 


F5P4 




E242 


NA 


Reset to 64/128 




F5BS 


F642 




E24B 


NA 


From SFF4D: G064 




F5BC 






E263 


NA 


Code to move to $02 




F5C8 


FS5F 


TALKK 


E33B 


ED09 


From SFFB4. send TALK on serial bus 


UDTIMK 


F5F8 


F69B 


LSTNK 


E33E 


EDOC 


From SFFB1 send LISTEN on serial 


RDT1MK 


F65E 


F6DD 








bus 


SETMK 


F665 


F5E4 




E43E 


ED40 


From $FFA5: send byte on serial bus 


NSTOP 


F66E 


F6ED 




EDAD 




Error Device not present 




F67C 


F6FB 


TKSAK 


E4D2 


EDC7 


From $FF93 send secondary address 
ISA) 




F67F 
F682 


F6FE 
F701 



From $FF96 send SA alter LISTEN 

From SFFA8. output byte on serial bus 

From SFFAB send UNTALK on serial 

bus 

From SFFAE: send UNLISTEN on 

serial bus 



Turn fast disk off 
Turn fast disk on 
From $FF47: flip last disk on/off 
Transmit RS232 
RS232 receive 
Set up RS232 input 
Get Irom RS232 
Interlock RS232/senal 
RS232 control I/O 
RS232 receive timing 
RS232 transmit timing 
Find any tape header 
Write tape header 
Get buffer address 
Get SA, EA ol tape buffer 
Find specific header 
Advance tape pointer 
"PRESS PLAY ." 
Check tape state 
"PRESS RECORD./' 
Initiate tape fead 
Initiate tape write 
Tape code 
Check tape stop 
Set read timing 
Reao tape bus 
Store tape characters 
Reset pointer 
New character setup 
Send transition to tape 
Wnte data to tape 
Tape write 
Tape leader 
Switch IRQ vector 
IRQ vectors 
Tape motor off 
Control tape motor 

From SFFE4.S032A. gel a char (usually 
keybd) 

From SFFCF.S0324 gel a char Irom in- 
put device 
Get char Irom tape 
From $FFD2.$0326. send char to out- 
put oevice 

From $FFCO,S031A. open file for 
read/write 

From $FFC6,$031E. prepare a file for 
inpul 

From $FFC9.$0320. prepare a file for 
output 

From SFFC3.S031C: close a file 
Search for file 
Set Me parameters 
From $FFE7.$032C abort I/O. close 
files 

From $FFCC.$0322. restore default I/O 
devices 

From $FF4A: clear I/O 
From SFFD5. load memory from disk 
or tape 
Load ($0330) 
Serial load 
Tape load 
Disk load 
Get serial byte 
Receive serial byte 
Toggle clock line 
■SEARCHING" 
■LOADING" 

From SFFD8: save memory to disk or 
tape 

Save ($0332) 
Terminate serial input 
"SAVING" 
Save to tape 

From $FFEA: update clock ( + 1) 
From $FFDE; read Tl clock 
From SFFDB: set Tl clock 
From $FFE1.$0328: scan STOP key 
"TOO MANY FILES" 
"FILE OPEN" 
"FILE NOT OPEN" 
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F68S 


F704 




F688 


F707 




F68B 


F70A 




F6BE 


F70D 




F691 


F710 




F694 


F713 




F71E 


F71F 




F722 




SETNAM 


F731 


FDF9 


SETLFS 


F738 


FEOO 




F73F 


NA 


READST 


F744 


FE07 


SETMSG 


F75C 


FE18 


MEMTOP 


F763 


FE2S 


MEMBOT 


F772 


FE34 


IOBASK 


F781 

F786 
F79D 
F7A5 
F7AE 
F7BC 
F7C9 


E5O0 




F7O0 


NA 




F7DA 


NA 




F7E3 


NA 




F7EC 


NA 




F800 


NA 




F8SA 


NA 




F867 


NA 




F890 


NA 




F9B3 


NA 




F9FB 


NA 


PRIMMS 


i-"A!7 
FA40 
FA65 
FF05 
FF17 
FF33 


NA 



"FILE NOT FOUND" 
"DEVICE NOT PRESENT" 
"NOT INPUT FILE" 

NOT OUTPUT FILE" 
"MISSING FILE NAME- 
ILLEGAL DEVICE NO" 
Pr.rt il direct 

Print I/O message 

From SFFBD: sel filename 

From $FFBA: set filer*, device*, sec 

adr 

From SFF68: set load/save Bank 

From $FFB7: read ST byte into A 

From SFF90: error messages on/off 

From SFF99 read/set upper limit of 

BASIC 

From SFF9C read/set lower limit ol 

BASIC 

From $FFF3. get start ot keyboard 

registers 

From SFF5C search for SA 

From $FF59: search/setup file 

From SFF50. trigger DMA 

Get character from memory 

Store loaded byte 

Read byte to be saved 

From SFF74 get char from Bank 

From SFF77, store char to Bank 

From SFF7A, compare char with Bank 

From SFF6B: gel memory control mask 

S/R to go to $02A2-$02FB 

DMA code to go to $03 FO 

From SFF56: check autostart ROM 

From SFF53: check for boot disk 

Read next boot sector 

Convert to 2 digit decimal 

From SFF7D: Print message 

NMI interrupt entry (S0318) 

Normal IRQ entry ($0314) 

NMI Iransler entry 

IRQ transfer entry 

Relurn from interrupt 



Kernal Table 



For space economy, this table gives C-128 vectors only. 





FF47 


NA 




FF4A 


NA 




FF4D 


NA 




FF50 


NA 


BTCALL 


FF53 


NA 


PHENIX 


FF56 


NA 


LKUPLA 


FF59 


NA 


LKUPSA 


FF5C 


NA 


SWAPPER 


FF5F 


NA 


DLCHR 


FF62 


NA 


PFKEY 


FF6S 


NA 


SETBNK 


FF68 


NA 


GETCFG 


FF6B 


NA 


JSRFAR 


FF6E 


NA 


JMPFAR 


FF71 


NA 


INDFET 


FF74 


NA 


INDSTA 


FF77 


NA 


INDCMP 


FF7A 


NA 


PRIMM 


FF7D 


NA 


RELESE 


FF80 






FF81 






FF84 






FF87 






FF8A 






FFBD 






FF90 






FF93 






FF96 






FF99 






FF9C 






FF9F 






FFA2 






FFA5 






FFA8 






FFAB 






F-AS 






FFB1 






FFB4 






FFB7 





Fast disk toggle (SE5FB] 

Clear I/O (SF23D) 

G064 ($E24B) 

Trigger DMA (SF7A5) 

Boot load program from disk (SFB90) 

Call card cold start rtnes (SF867) 

Search tables for LA (SF79D) 

Search tables for SA ($F786) 

Swap to alt display device ($C02A) 

Initialize 80 col character RAM ($C027) 

Program function key (SC021) 

Set Bank for LOAD/SAVE/VEFT1FY 

(SF73F) 

Convert Bank to MMU specification 

($F7EC) 

JSH to any Bank, RTS to calling Bank 

(S02CD) 

JMP to any Bank (S02E3) 

LDA (FETVEC).Y from any Bank 

(SF7D0) 

STA (STAVEC).Y to any Bank (SF7DA) 

CMP (CMPVEC).Y to any Bank (SF7E3) 

Print immediate ($FA1 7.always JSR 

here) 

Release # of KERNAL ROM 

Initialize screen editor ($CO00) 

Initialize input/output ($E109) 

RAM test (SE093) 

Reset vectors to default values (SE056) 

Change vectors for user (SE0S8) 

Control OS messages ($F75C) 

Send SA after LISTEN (SE4D2) 

Send SA alter TALK (SE4E0) 

Set/read lop of memory ($F763) 

Set/read bottom of memory (SF772) 

Scan keyboard (SC012) 

Not used in C128 

Handshake byte in (SE43E) 

Handshake byte out (SE503) 

Send UNTALK (SE515) 

Send UNLISTEN (SE526) 

Send LISTEN (SE33E) 

Send TALK (SE33B) 

Get I/O status ST (SF744) 



NMI 

RESET 
IRQ 



FFBA 

FFBD 

FFCO 

FFC3 

FFC6 

FFC9 

FFCC 

FFCF 

FFD2 

FFDS 

FFD8 

FFOB 

FFDE 

FFE1 

FFE4 

FFE7 

FFEA 

FFEO 

FFFO 

FFF3 

FFFA 

FFFC 

FFFE 



Sel LA FA SA (SF738) 

Set length, FN address (SF731) 

Open logical file ($031A.$EFBD) 

Close logical file (S031C.$F188) 

Open channel in (S031E.SF106) 

Open channel out (S0320.SF14C) 

C'ose I'O channels (S0322.SF226) 

Input Irom channel (S0324.SEF06) 

Output to channel (S0326,$EF79) 

Load from file (SF265) 

Save to file (SF53E) 

Set internal clock ($F665) 

Read internal clock (SF65E) 

Scan STOP key ($032S,$F66E) 

Get char from queue (S032A.SEEEB) 

Close all hies (S032CSF222) 

Increment clock ($F5FB) 

Read screen size (SC00F) 

Read/set X,Y on screen (SC0 18) 

Return I/O base (JF781) 

SFF05 = NMI 

SFF3D - rese: 

SFF17-IRQ 



Workspace In BANK 1 

BASIC 7.0 uses variable workspace in Bank 1 for its own re- 
quirements. A short list of recognized areas is given below. The 
list is not exhaustive, and care should be taken if you plan to 
use this space for your own programming. 



4189 
4267 
46FC 
47D8 

5250 
5AF0 

6A4C 
6CB3 
6FE4 
SFE7 
6FEC 

702F 
7039 
7691 

8490 
84 9 A 
BF76 
BF7B 
8F9F 

9005 
9485 
9CCA 
9D1C 

A627 
B6C3 
B715 
B721 

C033 
C04C 
C065 
C06F 
C60D 
C79A 
CEA8 

E073 
E105 
E2C7 
E2F8 

F50C 
FAB0 

FAD9 
FB32 
FB8B 

FBE4 

FF00 



Registers lor SD501 
BASIC links 
Action vectors 
Function vectors 

PjDEF characters 
Keywords/RENUMBER 

Colour codes 
Bil masks 
Voice parameters 
Length characters 
Command characters 

Bell sequence 
SID voice sleps 
Sprite vectors 

RND multiplier 

Value 32768 

+0.5 

Decimal constants 

Tl constants 

Exponent series 
Trigonometry series 
Video matrix lines hi 
Bil masks 

DOS command masks 

Mode taflles for MONITOR 

Mode Characters for MONITOR 

Compacted mnemonics for MONITOR 

Screen address low 

Screen address high 

I/O link vectors 

Keyboard shift vectors 

Programmed keys 

Vectors 

Programmed key lengths 

Vectors to $0314 
Bank transfer masks 
VIC 8564 setup 
CRT 8563 selup pairs 

"U0" disk reset 

Keyboard matrix unshifted 

(S033E.S0346) 

Keyboard matrix shifted ($0340) 

Keyboard matrix C = key ($0342) 

Kevboard matrix CONTROL key 

($0344) 

Keyboard matrix caps lock ($0348} 

MMU controls 
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NAME 

STREET ADDRESS 
CITY/TOWN/P.O. 



PROV/STATE 
TELEPHONE 



Sottwari 
= orde 
—for 



POSTAL/ZIP CODE 
MEMBERSHIP NO. 



TORONTO PET USERS GROUP, 101 Duncan Mi/1 Road, Suite G7, Don Mills, Ontario M3B 123 416-445-4524 



To order dub disks by mail, send SI 0.00 for each 
4040/2031/1540/1541 disk (4040 format), discount price 
5-10 S9.00 each, 11 or more S8.00 each; and S1200 for 
each 8050/8250 disk |8050 format). We do honour 
purchase orders from school boards. 




disks 



These disks are for use with a 
Please send me the following: 
3 Letter/No. 
Code 



computer and a . 



disk drive. 



Description 



4040 or 8050 
Format 



Price 



Total S 



.00 




tapes 



These tapes are for use with a 

If for a PET computer, what model - 

3 Letter/No. Code Description 



To order VIC 20 or Commodore 64 library 
tapes, send $6,00 for each tape. 
To order PET/CBM or Commodore Educa 
tional Software, send S10.00 for each tape. 

computer and a datasette. 

- BASIC - 1.0( ); 2.0j ); 4.0| )7 

Price 



Total S 



,00 






The prices indicated include postage and handling as well as 
Ontario Provincial Sales Tax [if applicable) 

D Cheque/money order enclosed [payable to TPUG) 



DVisa/Mastercard # 
Signature 




Library Additions 



TPUG's library of public domain soft- 
ware groivs month by month. Hundreds 
of disks containing thousands of pro- 
grams are available to TPUG members at 
the nominal cost often dollars per disk. 
Considering that each disk is packed with 
good programs, at today's software prices, 
this is a fantastic value. 

In order for the library to keep groiv- 
ing, our librarians need a constant supply 
of new programs. If you have written a 
program or a collection of programs that 
you think might be an asset to the library, 
please send it to: TPUG Program 
Library, 101 Duncan Mill Road, Suite 
G7, Don Mills, Ontario MSB 1Z3, 
Canada. If your contribution is accepted, 
you will be sent the library disk of your 
choice. If, for some reason, your contribu- 
tion is not needed, your original disk will 
be returned to you. 

On these pages our librarians describe 
recent additions to the library. 

VIC 20 Disk (V)TQ 

Presented by Richard Best 

The first disk/tape of 1986 starts out with 
a hectic game called Obliteration. This 
is a cross between Centipede and Space 
Invaders, in which you try to stay alive 
while continuously shooting at ap- 
proaching aliens. In Starbase, another 
space game, you protect your space sta- 
tion by firing rockets at the approaching 
asteroids. The popular game Berzerk has 
appeared on other VIC disks. This update 
is noisier, and also runs with a 
SuperExpander. 

Youngsters will find Timer/Add 
challenging — you have to solve as many 
addition problems as you can before the 
timer runs out. Cannibal is a simulation 
in which you set the ratio of cannibals to 
explorers. The explorers may not survive 
surrounded by hungry cannibals. Begin- 
ning programmers are not the only ones 
who will enjoy Dumb Prg, a clever demo 
of the CHR$() function. 

If you're anxious to press your VIC in- 
to service as a day planner, Chimes is just 
the thing. It allows you to set up to nine 
alarms, each with a message. Or how 
about a simple filing system? DBMS will 
store page after page of text and then 
save it all to tape . 

'Power users' will get a lot of use out 
of 5K Reset, 8K Off, and 8K On, which 
will help to clean up memory pointers, or 



enable and disable an 8K expander. And 
disk users have been screaming for Fast 
Format, a utility that formats a diskette 
in only 40 seconds. Once you've format- 
ted the disk, examine its surface with 
View BAM. 

The two remaining programs on this 
month's disk are truly unique. Men-Flex 
is a test for the cryptically inclined. It 
presents you with 20 number riddles 
derived from common phrases. Write + 
is a tool to be used by someone who is 
handicapped, and unable to communicate 
by norm means. It turns the VIC screen 
into a mt u of words and letters, and the 
joystick '■o a pointer. Sentences can 
then be v tten on the screen by selec- 
ting their parts from the menu. 

Many thanks to all those who con- 
tributed programs throughout 1985. With 
your continued efforts we should be able 
to keep the VIC alive for at least as long 
as the venerable PET. 

vie 28 disk (v)tq 

11 "list-me (v)t-q/1" prg 

10 "list-me {v)t-q/2" prg 
15 "oblit ins.vSk" prg 
15 "oblit ins.cass" prg 
IS "obliteration" prg 
6 "timer/add. v" prg 
8 "starbase ins.wSK" prg 
8 "starbase main" prg 
2 "5k reset. v5k" prg 
S "cannibal. w" prg 

12 "chimes. w" prg 

5 "dumb prg.v" prg 

11 "write+.v" prg 
25 "write+.seq" seq 
11 "berzerk. v5k* prg 
2 "8k off.v12k" prg 

1 "8k on.v12k" prg 
38 "men-f lex.v12k" prg 
8 "dbms.v" prg 
8 "fast format. vSk" prg 

6 "view bam.v5k" prg 

Commodore 64 Disk (C)TQ 

Presented by Derick Campbell 

This month's C-64 disk has great pro- 
grams for everyone. 

Telecommunicators won't want to miss 
the latest version of Xmobuf , a terminal 
program that is great for using on Delphi, 
CompuS ,ve, and on TPUG's own 



bulletin board system (though you will not 
be able to use the program for uploading 
and downloading on the TPUG BBS). 

For programmers, we have the 
ultimate super-utility: a program with all 
the commands you'd ever want, and all 
in one package: the DOS Wedge, Tiny 
Aid, Super DOS, Xtramon, and many 
more. 

If it's educational computing that in- 
terests you, we have a computer quiz — 
just right for students; while for rest and 
recreation there are two games, and a 
song — Karma Chameleon. 

Who could ask for more? Don't miss it! 

□ 

c-64 disk (c) tq 

8 "list-me Ccjtq" 
28 "tank combat. c" 

1 "pinball" 
160 "pinball. pb" 
3 "quiz . inst .c" 
5? "quiz.c" 
18 "prquiz.c" 
18 "super. aid. c" 
14 "wedge. inst .d" 
14 "tap. inst. d" 
21 "super. dos .inst ,d' 
42 "s , a. comments .d" 
36 "xman. inst .d" 
5 "tap.9b5b-9fff .d" 
18 "n&w.c780-cfff .d" 
12 "xmon.?4cc-B01b.d' 

9 "culture club.c" 
36 "chameleon. d" 
78 "xmobuf 7.4" 
55 "xmobuf.doc" 



prg 
prg 
prg 
prg 
Prg 
prg 
prg 
prg 
prg 
prg 
prg 
prg 
prg 

prg 
Prg 
prg 
prg 
prg 
prg 
seq 



C-128 Disk(Y)AA 



Presented by James Kokkinen 

This is the first TPUG library disk for the 
C-128 computer. Due to the relative 
'newness' of this computer, submissions 
to the library are just beginning to drib- 
ble in, so there are some unused blocks 
at the end of this disk. All contributions 
to the C-128 library will be gratefully ac- 
cepted for review and possible inclusion 
in future monthly diskettes. 

What we do have this month is an ex- 
tensive demonstration of some of the 
features of the C-128 computer, as well 
as some communications terminal 
programs. 
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iLibrary Additions 



Invention 13.mus is Commodore's 
demonstration of the C-128's SID chip 
playing two voices simultaneously. Sim- 
ple Key.mus and Music Board are short 
routines that allow users to create their 
own little tunes. Soundmaker allows easy 
creation of sounds that can be used in 
games, or as audible prompts in other 
programs. 

There are four communications pro- 
grams on this month's disk. Small- 
term. 128 is an X-Modem protocol ter- 
minal that, as well as CP/Term.128, can 
download to single-sided C-128 CP/M 
diskettes. The List Me (T)T1, as well as 
the sequential documentation files on this 
diskette, explain the above files in more 
detail, as well as Tacoterm.128, CP/M 
term2 and JHF Miniterm. 

In the recreational vein, there are two 
games included this month. Litter Patrol 
is a one-player game that has the partici- 
pant collecting garbage strewn over the 
highway by non-environmentally-minded 
automobile passengers. Deepsix.128 has 
the single participant diving for gems and 
dodging various underwater hazards. 
Both games are enjoyable examples of 
what one can create with the C-128's 
simplified graphics commands. 

Sprites on 128 is the text of Sean 
Rooney's well-received presentation to 
the February C-128 meeting. The balance 
of the sprite programs on this diskette 
were created and/or adapted by Sean for 
his presentation, and are included here 
for your enjoyment. 

The utilities included are mostly taken 
from the 1571 Demo Diskette, with a few 
exceptions, some of which are noted here. 
Uni-copy is Jim Butterfield's (it works in 
128 mode as well!). Keypad 64.C-128 is 
actually a C-64 program that permits the 
use of the C-128's keypad and cursor keys 
while in C-64 mode. 2 1571 keys allows 
the use of DOS commands for those for- 
tunate enough to own two 1571 disk 
drives. 

As noted by Bill Graves in the List Me 
program, several of these programs were 
downloaded from various bulletin board 
systems and, to the best of our 
knowledge, are all in the public domain. 

Editor's note: There will be no PET disk 
this month but Mike Donegan informs us 
that there will be an Amiga disk by the 
time you read this. D 



c- 


-128 dis 


k (y)aa 




1? 


"list 


me C t)t1" 


Prg 


1 


i* 


.music ..... " 


prg 

prg 


7 


"invert 


tion 13.mus" 


3 


"simpl 


e key.mus" 


prg 


3 


"music 


board" 


prg 



2 "soundmaker" prg 3 
1 "..communications" prg 1 
3? "smallterm.128" prg 14 
SI "cp/tn term. 12B" prg 8 
16 "cp/mterm.doc" seq 9 
69 "tacoterm.128" prg 14 
18 "cp/m term2" prg 8 
5 "jhf miniterm" prg 6 
13 "jhf miniterm doc" seq 8 

1 "..games/demos..." prg 8 

13 "litter patrol" prg 5 

14 "deepsix.128" prg 5 
IB "sprites on 128" seq 9 
7 "sprsav demo" prg 4 

3 "bent space" prg 8 

2 "black hole" prg 4 

3 "wavy spokes" prg 2 



car race prg 

"...utilities..." prg 

"uni-copy" prg 

"dir print" prg 

"dir squeeze" prg 

"disk-dump" prg 

"display bam" prg 

"change unit" prg 

"unscratch" prg 

"load address" prg 

"seq lister" prg 

"header change" prg 

"printer test" prg 

"format disk" prg 

"autoboot maker" prg 

"keypad 64.c128" prg 

"2 1571 keys" prg 



We'll Send You Money! 



That's right — TPUG Inc. will send you — with NO 
obligation (on our part) — hard cash that you can spend 
as you please. You don't even have to be a TPUG member! 
Hard to believe? It's true! 

Here's how to take advantage of this special offer: 
Just send us a self-addressed stamped envelope, along 
with an original unpublished article suitable for TPUG 
Magazine. The topic doesn't matter — just make sure that 
it relates to Commodore computers, and that it's brilliant. 
We do the rest. 

Your article should be on a Commodore disk, preferably 
with accompanying hard copy. Sequential PET ASCII files 
are best, with no embedded word processor commands, 
but other formats are acceptable. Just be sure to state both 
disk format and word processor used on the label of the 
disk, along with your name and the filename of the article. 
We'll get back to you as soon as possible, usually within 
three weeks of receiving your submission. 

By the way, if you have an idea for an article, but you're 
not sure whether it's suitable for TPUG Magazine, check it 
out with us first. Just call (416) 445-4524 (9 to 5 EST 
weekdays), or drop us a line at: Submissions Department, 
TPUG Magazine, 101 Duncan Mill Road, Suite G-7, Don 
Mills, Ontario, Canada M3B 1Z3. 



And remember, if we print your article 
money! 



we'll send you 
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Micro Processes. 



Amiga/C-64 
File Transfers 



by Chris Johnson 

I am writing this article with Ed, the full-screen editor that 
comes as part of AmigaDOS. When I write an article for TPUG 
Magazine, I usually send it by modem. Unfortunately, I have 
neither a modem nor a terminal program for the Amiga; I do 
have a Commodore 1650 modem and several terminal programs 
for my C-64. 

I also have a null-modem cable that I use to connect (the two 
computers {with a V1C-1011A interface on the C-64); and the 
AmigaDOS has commands that enable the transfer of material. 
(These would work just as well if there was a modem connected.) 

On the C-64 I load a terminal program with a buffer. I am 
using FirstTerm, which is available on a TPUG disk. I open the 
buffer with logo-b. I am using the default communications speed 
of 300 BIPS, though I could increase it to 1200 BIPS. (The C-64 
does not receive reliably at higher speeds than that, though I 
regularly send material from a C-64 to another computer at 2400 
BIPS.) 

On the Amiga, I have used Preferences to set the baud rate 
at 300. 1 open a CLI window and enter the following command: 
type < filename > to sen. This command will be familiar to 
users of CP/M or MS-DOS, but new to most Commodore users. 
If I had left off the to ser:, the file would have been printed 
on the screen. As it is, the file is sent to the serial port, through 
the null-modem cable, and into the buffer of my C-64. When the 
file is received, I leave terminal mode on the C-64, save the buf- 
fer to disk, and ship it later to TPUG Magazine by modem. 
The same command can be used to receive files from another 
computer. This time, the command is: 

TYPE SER: to df0:<filename> 

This takes the bytes coming in through the serial port and stores 
them in the specified file. To exit and close the file, type CTRL- 
C on the Amiga; this will not take effect until the incoming buf- 
fer is full , so transmit a string of characters (spaces will do) from 
the other computer until the * *BREAK appears on the Amiga. 

There is one small problem, however, with sending Ed files 
from the Amiga, which is that Ed stores data line by line, with 
a linefeed character (chr$(1 0)) at the end of each line. Most word 
processors on Commodore computers use the carriage return 
character (chrS(1 3)) as the terminator, and then only at the end 
of each paragraph, not each line. 

But it is not hard to write a program to strip the unwanted 
linefeeds from the file. The only requirement, when preparing 
the Ed file, is that a 'hard' line ending — one that will not be 
translated to a space when the file is formatted for printing or 
typesetting — must be entered with two carriage returns. This 
is normally done at the end of a paragraph, for instance, and 
at the end of each line of such data as program listings. 

The stripping of the unwanted characters can be done at either 



end. I use the following ABasiC program on the Amiga to send 

the files and strip the line endings at the same time. 

10 cnl$ = chr$(155) + "E" 

20 unS = chr$(10) 

30 headers = homeS + cnl$ + "Transmit file to serial port." 

+ cnl$ + chr$(10) + string$(37," = ") 

40 print headerS; cnlS 

50 input "Filename"; filenames 

60 on error goto 1 80 

70 open "i", #1, filenames 

80 open "o", #2, "sen" 

90 while not eof(1) 

100 line input #1, aS 

110 if lastline% and len(aS) then print #2, " "; 

120 print #2, aS; 

130 if len(aS) = then print #2, chr$(13); chr$(13); 

140 lastline% = len(aS) 

150 wend 

160 close 

1 70 end 

180 print errS(err): cnlS 

190 print "Press any key to continue." 

200 getkey iS: scnclr: resume 40 □ 



Formatting MFM Disks 
on the 1571 Disk Drive 



by M. Garamszeghy 

Copyright ® 1986 M. Garamszeghy 

The 1571 disk drive is capable of reading and writing a number 
of standard CP/M disk formats when used with a C-128 in CP/M 
mode, including (among others): 

• IBM CP/M-86 single-sided 

• IBM CP/M-86 double-sided 

• Kaypro II single-sided 

• Kaypro IV double-sided 

• Osborne single-sided 

• Epson QX-10 double-sided 

• Sheer 9 

These are all referred to as MFM (maximum frequency modula- 
tion) formats, based on the technique used to record the data 
on the disk. Normal Commodore DOS (used by the 1541, for 
example) uses a method called GCR (group coded recording), 
which is totally different from MFM. There are several other 
differences between MFM and GCR disks. MFM disks gener- 
ally have the same number of sectors on each track, while Com- 
modore GCR disks usually have different numbers of sectors 
for different ranges of track numbers. MFM tracks are 
numbered from zero, while the sectors on each track are 
numbered from one. This is the opposite of Commodore GCR 



32 TPUG Magazine 



disks, where tracks are numbered from one and sectors start 
at zero. 

Although Commodore CP/M can read and write in MFM for- 
mats with a 1571 drive, the current version of the format.com 
program supplied on the CP/M system disk cannot create or for- 
mat new disks in these extended disk formats. It is, however, 
quite simple to format disks in these or any other format you 
wish with a 1571 drive. 

In addition to the standard Commodore DOS commands, the 
1571 has a few new ones. These commands, collectively defined- 
as 'burst mode' in the 1571 manual, allow you to read, write 
and format disks in virtually any format you choose. Most of 
the commands, such as those for reading from and writing to 
the disk, need fairly sophisticated machine language program- 
ming to access, because the required high-speed data transfer 
is under totally manual control . The extended format command 
is the simplest to use. It can be quite easily invoked from BASIC 
because high-speed data transmission is not required. 

The description of the burst mode commands in the 1571 
manual is cryptic at best. The syntax for the MFM format com- 
mand can be simplified to: 

open15,8,15,"uB"+chr$[b1)+chr$(129)+chr$(0 
) +chr$( b4) +chr${ 39) +chr$( b6) : dolose 

In this instruction, bl must be set to 70 for a single-sided disk, 
or 102 for a double-sided disk; bJt is a number from to 3, 
representing 128, 256, 512 and 1024 bytes per sector respect- 
vely; and b6 is the number of sectors per track. 

The actual bit patterns in the characters sent after the UO 
(which selects the burst mode) are explained in detail in the 1571 
manual. I have simplified them here to make the command easier 
to use. There are other optional parameters that allow you to 
partially format a disk, format different areas of the disk in a 
different manner, change the sector slew rate, change the fill 
byte, and so on. These can be the basis of, for example, a sim- 
ple yet very effective copy protection scheme that you can use 
on your own disks and programs. Try reformatting track 35 on 
a standard 1541 DOS disk with the instruction: 

open15,8,15,"u0"+chr$( 198) +chr$( 129) +chr$( 
0) +chr$( 0) +chr$( 3B) +chr$( 10) +chr$( 34) +ch 
r$(34) :dclase 

Now see what happens when you try to copy the disk, even with 
a whole-disk nibble-type copier for protected disks. If the pro- 
gram you wish to protect tries a random access block-read or 
block-write to the reformatted track, an error will result. If the 
drive (either a 1541 or 1571) does not return an appropriate read 
error code, the disk has been formatted in GCR and is obvious- 
ly not an original. The reformatting of track 35 should be done 
before you copy your program to the disk, in order to ensure 
that no program data are lost by wiping out the track. In addi- 
tion, you should use the DOS block-allocate command to 
allocate all sectors on the track, to prevent DOS from acciden- 
tally trying to write there. 

The following short BASIC 7.0 program, MFMFormat, is for 
use in the C-128 native mode. It allows you to effortlessly for- 
mat disks in a number of different MFM formats on the 1571 
drive. The DATA statements at the end of the program contain 
the required parameters (sectors per track, bytes per sector and 
number of sides) for each type of disk. These parameters can 
all be changed to create custom disk formats if you wish. 
However, most of the possible formats will not be supported 
by CP/M on the C-128. In addition, the line numbers for the 
DATA statements should not be changed, due to the use of a 
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calculated line number reference in line 30 for reading the 

selected data. 

10 print" mfm disk formatter" :pri 

nt" by m. garamszeghy" 

20 print" options: " :fori=1 to5:reada,a,a,a 

$:printi": ";a$:next 
30 input" select a format";f :restore( f*10 

+100) :read b6,bs,sd,fS 
40 print" format >> ";fj:print" press <r 

eturn> to continue" 
50 print" or press any other key to abort" 

;getkeya$:ifa$<>chr${ 13) then run 
60 b5=39:s(0)=128:s( 1) =2S6:s( 2) -512: s( 3) =1 

024:si-0:ifsd=2thensi=32 
70 b1=70orsi:fori=0to3:ifbs=s( i)thenb4=i:e 

lsenext 
80 open1S,8,15,"u0"+chr$(b1)+chr$( 129)+chr 

$[ 0) +chr${ b4) +chr$C 39) +chr$( b6) 
90 input#15,a:dclose:input" format anothe 

r <y/n>";fa$:iffa$="y"then40 
100 data8 t S12, 1 ,"ibm cp/m-86 single-sided 
110 datafl, 512,2, "ibm cp/m-86 double-sided 
120 data10,512,2,"kaypro iv double-sided 
130 data10,S12, 1,"kaypro ii single-sided 
140 dataB, 1024, 1 ."osborne single-sided 



A Secret in a 
DRAW Command 



by Elizabeth Deal 

There is an undocumented polar -coordinate drawing command 
in the BASICs for the newer Commodore machines, the Plus/4, 
the C-16 and the C-128. If you disassemble Plus/4 ROMs, you 
will see that the DRAW command begins at $C4D9. It uses 
several subroutines, of which one — at $C3F7 — is of interest: 
it fans out to do various kinds of jobs depending on which of 
many permitted syntaxes are in the program. The system tries 
to get X and Y coordinates but, if it finds them separated by 
a semicolon (the test for this is at $C400-C405), what would be 
X is taken to mean radius length, and what would be Y is taken 
to mean an angle (North is degrees, East is 90, and so on. 
Notice I said 'degrees' — not 'radians'!). A value over 360 
degrees wraps around back to zero, but there is a two-byte limit 
on its size. 

The variety of permitted syntaxes seems almost unlimited. 
The following two programs will allow you to study this useful 
variant of the DRAW command in more detail. 

In the Rays program, line 150 just plots a point 25 pixels away 
from the center, placed at x =y = 100, at an angle varying with 
J, which in this case is 12 points on a circle, every 30 degrees 
(like the hour markers on the clock). If you add , one by one, the 
remaining lines (listed here with REM in front of the code) you 
should be able to see how DRAW behaves. 

Pressing any key cancels the graphic mode, so you can play 
with the program. 

In the Tiny Turtle program, the drawing angle is a sum of 
previously used angles, so that you can draw in the same fashion 
as in the LOGO language. 'Distance' is LOGO'S forward com- 
mand, and 'angle' is LOGO'S turn command. A bunch of 
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60-degree turns with the same distance value will close up a 
hexagon. 

I am not testing DA for a 360-degree limit; you may wish to 
do that. To get out of the input loop , just enter negative values. 
SCALE 1 allows fairly large values to he used — see your manual 
for details. 

100 rem rays 

120 scale Orgraphic 1,1 

130 n = 12:a = 360/n 

140 for j = to n:da = j*a 

150 draw 1,100,100,25;da 

160 rem draw 1 to 35;da 

170 rem draw to 4; da 

180 rem draw 1 to 10;da 

190 next j 

200 get key i$:graphic 

100 rem tiny turtle path 

110 scale 1:graphic 2,1 

120 locate 100,100:da = 

130 inpufdistance, angle";d,a 

140 if d<0 or a<0 then graphic 0:end 

150 da = data 

160 draw 1 to d;da 

170 goto 130 

A project: A spiral is a straight line in the polar coordinate 
system. Try writing a tiny routine to draw at least five swings 
of a spiral. □ 






Printing Graphs 

from the 

Home Accountant 



by Karl Thurber 

As furnished by Continental Software, the popular Home 
Accountant program for the Commodore 64 can generate and 
save a variety of graphs to disk, but you're on your own in figur- 
ing how to print out those saved graphs — at least in Version 
"E" of the program (which I have), and previous versions. Here's 
one way to print out those fancy household graphs, if you have 
a printer utility program such as is contained on the Cardco 
Printer Utility Disk: 

• Generate the desired graph and SAVE it to disk, using the 
GRAPHS option of the Home Accountant MAIN MENU. 

• Using the Cardco disk, load the Printer Utility program and 
select the Keyed Screen Dump option from the menu. Choose 
a memory location from the menu for the dump (Choice 1, $C800, 
works well). Indicate your type of printer (I use a Gemini 10X), 
and indicate whether you want a single or double density print- 
out (the former is easier on the ribbon). When the READY 
prompt appears, type in the required SYS command. Now, you 
are ready to dump a screen by hitting the Fl function key on 
your keyboard. 

• Now, load the Home Accountant GRAPH module. Note that 
this is an entirely separate program on your disk from the main 



set of Home Accountant programs, and is not the GRAPH op- 
tion accessed from the MAIN MENU. Use this program to LOAD 
in your saved graph. 

• When your saved graph finishes painting itself on the screen, 
and the disk drive light goes out, hit the F1 key. Your graph 
should be dumped to your printer. 

The graphs that result are somewhat elongated from how they 
appear on the screen, but nevertheless look quite professional. 
Other screen dump utility programs can be used, but the Card- 
co program is inexpensive and simple to use, and it „ -videly 
available. 

If you have trouble with the printouts, experiment with the 
DIP switch settings on your interface and/or printer, or with 
the memory location you selected for the screen dump routine 
from the Cardco Printer Utility program (four default locations 
are available). I found that my 10X gave good results with my 
Tymac Connection printer interface set to the 'transparent' 
mode with line feeds on. □ 



Organize Your 
Disk Directories 



by Karl Thurber 

How often have you forgotten which directory entries belong 
with which set of programs? Which program is the one to load? 
Which program is the instruction file? 

If you work with programs that involve several sub -programs 
or files, it's well worth your trouble to organize their placement 
on the disk. A typical scenario would be to have an "empty" 

filename that shows what follows, such as " Blaster Game". 

The first file should be the one you load, and may be called the 
program's name, or perhaps "Boot". The main program files, 
loaded by the boot (if any is required), may be indented or other- 
wise labeled so that you don't try to load them directly. After 
the last sub-program directory entry, either enter a blank line, 

" " , or start another empty filename for the next 

series of programs on the disk. 

Leave room at the top of the list for a menu, DOS wedge, or 
your favourite utility. For example, if your first entry is a menu 
for the whole disk, you can 'autorun' it by typing LOAD "*",8:, 
then hitting SHIFT/RUN-STOP. This adds a professional touch 
to your programming. 

A word of caution: when repeatedly scratching and re-saving 
programs, you may find that your 1541's DOS has moved the 
relative position of your files within the directory. Thus on first 
inspection, your files may have apparently 'disappeared'. You 
can reorganize the disk if this happens, using the Copy command 
of the DOS Wedge; better yet (at least less confusing), use a 
file-by-file copier to transfer the files to a new disk. This will 
also let you reorganize the order of the files on the disk. 

Also, don't run your directory listings through a program that 
alphabetizes your entries if you follow this technique! Your direc- 
tory entries will then be in alphabetical order, but you want them 
in program order! D 
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Inexpensive 
Disk Drive Fans 



a plastic or metal grill when you buy your fan, if avail ble, to 
prevent finger-damage! Finally, install four small rubber moun- 
ting feet (the sticky -back kind is best) on the fan to keep it from 
marring the top of your disk drive when it rests on the drive. 
Arrange the airflow to blow in or out — it's your choice! 



by Karl Thurber 

Would you like to cool your disk drive for under $10? For over 
a year I have cooled my 1541s with 'new surplus' muffin fans. 
Flat and square-shaped, muffin fans are used to reduce the in- 
ternal temperature of much electronic equipment — just what's 
needed to make a 1541 run cool. 

Muffin fans are often sold used for $4-6 and as new surplus 
for $7-9 through electronics parts houses and surplus vendors, 
who advertise in the pages of such electronics publications as 
Radio-Electronws. Many of the amateur radio publications, such 
as 73, QST, CQ and Ham Radio, also carry ads from such sup- 
pliers. Look for the magazines, and send for the catalogs of ap- 
propriate vendors. The fans are in plentiful supply ; you just need 
to find out which firms stock them. 

Even better, attend a local 'hamfest' or 'flea market' at which 
used and surplus electronic equipment is sold. Almost always, 
there are dealers and individuals in attendance who sell such 
fans. Consult the magazines listed above for news about these 
events, or, if you know a local ham radio operator, ask him when 
the next hamfest is scheduled in your area. 

Some cautions: be sure you obtain a 110-130 VAC 50/60 cy- 
cle fan (other fans look the same); and try to obtain the special 
little connector plug that mates with the one on the fan. Obtain 



Saving Disk Directories 



by Karl Thurber 

If you don't own a printer, but would like to have a record of 
early versions of a particular disk's directory, you can actually 
load in the directory and immediately save it to disk, where it 
is stored just like any BASIC program. 

For example, if you have a particular disk that you're about 
to rearrange, and would like to be able to recall the particular 
programs that were on it, and their order in the directory, before 
working on the disk, do this: LOAD "$",8 to bring the disk's 
directory into the computer's memory. Add any comments you'd 
like to have saved, such as the date (don't worry much about 
syntax, since this is a non-runnable program). Save what you 
have to another disk, giving the saved directory a convenient 
Filename. The saved directory may be recalled at a future date , 
should you wish to know what the directory looked like at a cer- 
tain time. 

In experimenting with this procedure, I found that I could not 
save the directory under the reserved filename "$". However, 
"DIRECTORY" or "CATALOG", or filenames with these words 
in them, would work okay. □ 



OS/9 Software 

NOW AVAILABLE! 



Word Processor - 
Stylograph III 

Mail merge, Spell checker. Menu driven, 
fast. Extensive features. Formats to screen 
as you work US $149 Cdn $210 

C Compiler 

A full implementation of K & R standard C, 
with double precision variables. 
US $138 Cdn $170 

BASIC09 

A fully structured, sophisticated semi- 
compiled (I code) BASIC. See Byte 
magazine April 1984. . US $110 Cdn $155 



FORTRAN 77 

Full FORTRAN compiler .. .coming soon. 
US $120 Cdn $166 

DynaStar, DynaForm, 
DynaSpell 

A full screen (similar to microEDIT) editor, 
text formatter and spell checker. 
US $90 Cdn $127 

Other: Pascal, DynaCalc, Database etc., available on 
demand. 

To Order: Send a cheque or money order {add $10 for 
shipping/handling and 7% PST where applicable) to: 
TPUG, 

101 Duncan Mill Rd., Suite G-7, 
Don Mills, Ontario, Canada M3B 1Z3 
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Movie Maker 

from Electronic Arts 

Animation program 
for Commodore 64 



Review by Mike Martin 

Electronic Arts has just rereleased a pro- 
gram called Movie Maker. This anima- 
tion program came out several years ago, 
at much higher cost — almost double that 
of this version. The new incarnation in- 
cludes more material, in the form of some 
animation by the bizarre cartoonist 
Gahan Wilson. 

Movie Maker comes on two double- 
sided disks with a manual written for 
Commodore, Apple, and Atari versions. 
The manual begins with a tour of the 
'studio' and descriptions of production 
terms and commands. At first glance, the 
program seems very complicated, but 
each section involves just a few com- 
mands, and is easily mastered. 

The program allows the creation of 
'movies' with fairly detailed animation, 
but with many restrictions. Three hun- 
dred 'frames' of animation are permitted. 
Standard theatrical movies run at 24 
frames, or individual pictures per second. 
At that rate, these 'movies' would be lit- 
tle longer than 13 seconds. Movie Maker 
permits the selection of nine speeds, so 
the production can run longer, depending 
on the detail desired. Each film consists 
of up to six video tracks, with a maximum 
of 16 sequences of animation, and three 
sound tracks. 

You start by making your drawings, in 
the Composing Room. You have two 
screens resident. One is the Background; 
the other contains all the drawings you 
plan to use. You are permitted four, and 
only four colours. This is limiting, as the 
same four colours (including the 
background) must be used all the way 
through. You may choose from all the 
usual 16 colours. If you draw a blue sky, 
and green grass, you then have two col- 
ours left for people or buildings. The 
graphics editor is limited and slow. After 
drawing your first figure, you 'outline' it, 
or define it so the computer knows where 
it is. You then duplicate it right next to 



the first drawing, and change the position 
of an arm or leg. The process continues 
until you have all the positions you need. 
The editor allows change of pen colour, 
fill, erase, duplicate, and mirror, but not 
'plot' or 'shapes'. By loading an 'Xtra 
Function File', you may add text or 
change the scale (size) of a drawing or 
text. While drawing is difficult, most 
figures only require three or four posi- 
tions to animate walking or other 
movements. The figures are on the rough 
side. 

After completing the drawings, you 
then define the sequences. For my first 
project, I drew a monitor with 'TPUG' in 
large letters, and 'READY' in small let- 
ters with a flashing cursor. The cursor 
turns into a butterfly and flutters off the 
screen. My first sequence was composed 
of a small square alternating with a blank 
frame. I set the speed at four, and let it 
cycle between those two drawings. I 
followed this with a four-frame sequence 
of the butterly transformation, followed 
by a four -frame sequence of the wings ful- 
ly extended, then half-folded, and fully- 
folded, then back to half-folded. This se- 
quence cycled over and over. After posi- 
tioning the 'cursor', I recorded a few 
seconds of it flashing. Then when the 
transformation sequence finished , I used 
the joystick to define the movement of 
the butterfly around the screen. One com- 
mand allows the choice of how many pix- 
els each figure moves at a time. 

After recording the animation music, 
an 'Xtra' file is loaded for sound. One file 
is just sound effects. Number keys 1 
through 9 are used to call up individual 
effects, and silences them. The other 
'Xtra' file is for music, but has only nine 
notes, with no provisions for volume, or 
defining the notes in any way. 'Limited' 
may be too kind a word for the musical 
capabilities of Movie Maker. 

With the background, shape, anima- 
tion, and sound files in memory, you can 
choose the smooth function, which con- 
verts the files into a completed produc- 
tion. It evens out the animation, and 
creates a final file. The smooth function 
permits the addition of credits at the head 
and tail of your feature. They scroll neatly 
by. 

Text may also be used as a sequence 
within the film, and manipulated on 
screen along with your drawings. 

Several files can be transferred to your 



data disk to run your movie without 
Movie Maker loaded into your computer. 
These files include a number countdown, 
and several frames of credits for the com- 
pany that made the program. 

The manual presents several ideas for 
the use of your movies, but the best one 
involves making titles and credits for 
your videotapes. Also suggested is the 
creation of animated 'greeting cards' for 
your friends. The program is fun to use, 
and will provide hours of entertainment 
for children. (My 'Butterfly' classic took 
three hours to complete.) It might even 
inspire a few new -generation Walt 
Disneys. It won't, however, put the 
National Film Board out of business. □ 



Printer Book For 

The Commodore 64 

by R. Bruckmann, 

K. Gerits and T. Wiens 

Abacus Software, 1 984 
350 pages, $19,95 (US) 



Review by Ranjan Bose 

I have a 1526 printer, and after buying 
this book my first reaction was — why did 
I bother? It contains only a few pages 
about my printer, and not all the infor- 
mation is accurate. Having purchased the 
book, though, I read it anyway, and 
discovered that it is, all told, a fairly good 
source of general information about dif- 
ferent printers and interfaces. It also 
shows how to hook up an electronic 
typewriter to your 64. 

The 1525/MPS 801 printers and the 
1520 plotter get the lion's share of the at- 
tention. For owners of the latter machine, 
this book is the only source of vital infor- 
mation and utility programs that I know 
of. Useful hardcopy and high resolution 
screen dump routines for several printers 
are provided (including the odd 1526). A 
useful routine for printing formatted- 
tabular printouts is there as well. A com- 
plete description and memory map of the 
MPS-801 operating system is included. 
The optional accompanying disk ($14.95 
US) has all the programs and subroutines 
from the book and is a worthwhile 
purchase. □ 
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Print jHaster 
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Review by Mike Martin 

As I moved towards the back of the store, 
it caught my eye. I approached cautious- 
ly, and glanced at the box out of the cor- 
ner of my eye. I picked it up, sniffed, and 
then shook it. After reading the box five 
or ten times more, I bought it. 

After all, Print Shop by Broderbund 
was my first love. It has faithfully served 
me for over a year, and even provided 
more disks of graphics, with the promise 
of a companion disk of more borders, 
fonts, and a graphics editor with class. 
Could I be unfaithful to Print Shop after 
all this? 

The similarities between the two 
packages are striking. Print Shop was 
first released for the Apple computers, 
then translated for Commodore, Atari, 
and finally IBM. Print Master by Unison 
World was written for the IBM, then 
translated for Commodore, Epson, and 
a CP/M version for Kaypro and com- 
patibles. Print Master appears to be 
heavily inspired by Print Shop. I wasn't 
expecting much other than a slightly dif- 
ferent version of Print Shop. But its pale 
yellow box contained some large suprises. 

I will have to rely heavily upon com- 
parisons between the two programs. If 
you are one of the two people in the 
universe who do not own Print Shop, the 
decision won't be all that difficult. If you 
do own Print Shop, you may agonize for 
hours before adding Print Master to your 
graphics collection. 

The package contains your disk, and a 
manual that is functional, but not flashy. 
Also enclosed are your registration card, 
and several offers including an additional 
graphics disk, a book on graphics design, 



and a backup disk for five dollars (US). 
At five dollars, I consider a backup disk 
to be a much needed service to the 
customer; anything over ten dollars I con- 
sider to be an exploitive rip-off. 

Print Master's heavy-handed copy pro- 
tection will teach your disk drive to dance 
and sing. That steady 'load' light I've 
come to expect, quickly became a flashing 
strobe light. My 1571 danced and flash- 
ed for a few minutes, and I wonder what 
the 1541 would have done. 

At first glance, the program resembl- 
ed Print Shop, although the first display 
was rather obviously designed for an 80 
column monitor. The title screen was not 
readable, but the following menus were 
just fine. The screen display is black and 
white and offers the choices of Greeting 
Card, Sign, Stationery, Calendar, Ban- 
ner, and Graphics Editor. Printer Setup 
and Exit to BASIC are also included. 

Operation of the program is almost 
identical to Print Shop. A border is 
selected from the menu by highlighting 
the choices. Each choice displays a small 
section of the border, rather than the 
whole thing. The borders are very dif- 
ferent than those on Print Shop. They in- 
clude thick and thin lines, a simulated 
wood frame, a paper with a 'drop shadow' 
3-D effect, nouveau-art deco, cars, 
footsteps, 'bang', lace, ants, and 
'Christmas'. 

A graphic is selected from the screen 
listing of twelve titles, plus 'next' and 
'previous' pages. But in addition to the 
list of names, you are given the option of 
seeing each of the graphics listed on the 
page. A chunk of twelve are loaded at one 
clip; then by moving the cursor 'highlight' 
up and down, each art cut is displayed on 
the screen. I consider that a big plus. 

After selection of an art cut, you are 
given your choice of three sizes, and 
various positions to place them, including 
staggered and 'tiled' as a background pat- 
tern. The cursor is used to move up or 
down on custom placement, and each 
position is marked by a dotted line that 
revolves much like the flashing lights on 
a movie marquee. 

Next, the type style is chosen. Eight 
fonts are offered, and I like them better 
than those offered by Print Shop. I find 
that I only use two or three of the fonts 
on Print Shop, as some are too large or 
too ornate. The Print Master type fonts 
are more functional, and include both up- 
per and lower case letters. That alone 
makes the package worth purchasing, as 
far as I'm concerned. It means that you 
can fit in longer lines, but provide an all 
capital headline if desired. The spacing is 
proportional, allowing less space for an 



T than an V. In most formats, the fonts 
are available in two sizes, and also in your 
choice of solid, outline, or 3-D forms. 

When you start to print your creation, 
the next couple of suprises hit. The pro- 
gram moves the commands to a small 
window, then opens another window and 
draws the completed page on your 
screen . You are then given the chance to 
go back and make corrections if needed, 
and are offered the option of saving the 
page to disk. What a nifty idea! On the 
greeting card section, it draws the front 
of the card, then moves that window to 
the corner, and draws another window to 
create the inside of the card. You may 
edit and correct a design without having 
to reload graphics, as in the Print Shop 
program. 

The program supports Okidata 82A, 92, 
and 192; Okimate 10; Epson RX, FX, and 
MX-Graftrax; Star Micronics 10X/15X; 
C. Itoh 8510; Commodore VIC-1525, and 
MPS-801. The box lists Cardco and Tur- 
boPrint/GT interfaces, but my Xetec 
graphics Sr. worked as well. Print quali- 
ty does not seem to be quite as high as 
on Print Shop, because the occasional 
white lines between printhead passes are 
a bit more noticeable on my Gemini 10X. 

The Calendar option prints either mon- 
thly or weekly versions. You select month 
and year, and you may include a graphic, 
alter the heading a bit, and put some text 
inside an individual day (but only three 
lines of eight characters). The Stationery 
option is similar to Print Shop, but allows 
two lines of text or one large line, and no 
address lines. 

The Graphics editor is similar also, and 
just as limited and frustrating. Draw with 
a joystick, and swap the black and white 
sections, plus flip the picture left to right, 
or flip it upside down, and save it to disk. 
The file created is three blocks long, and 
will load into Print Shop, but is read dif- 
ferently, so it won't be recognizable as 
anything. It resembles the sideways pic- 
ture on a TV set caused by misadjusting 
the vertical hold control . But don't lose 
hope. Some programmer will soon come 
up with a translation program to swap 
artwork back and forth. In the meantime, 
just load up one of the programs and print 
just the graphics, then use a second pass 
through the printer with the other pro- 
gram for your borders and text. 

Do you need both programs? Probably 
not. If you can afford just one — which 
one? Probably Print Master. 

Will I give up either program? Hell no. 

Print Master, by Unison World, 2150 
Skattuck Ave. #902, Berkeley, CA H704. 

n 
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Typing Tutor III 
with Letter Invaders 

from Simon & Shuster 

Typing instruction 
program and game 
tor Commodore 64 



Review by Malcolm O'Brien 

The first thing you'll appreciate about 
Typing Tutor III is the documentation 
— a lovely hard cover (!) manual with nice 
typeset sheets and a metal spiral binding. 
Full marks to Simon & Shuster's Elec- 
tronic Publishing Division for going the 
extra mite to provide would-be typists 
with high quality materials. The disk is 
inside a plastic 'page' bound into the back 
of the manual . This is preceded by the 
End User License Agreement, which is 
quite similar to the ones you may have 
seen on the slipcases of IBM software 
packages. The Agreement gives you per- 
mission to "make one copy for back-up 
purposes provided you reproduce and in- 
clude the complete copyright notice on 
the back-up copy". This copy is, of course, 
for your own use on your own C-64. Do 
read the Agreement before opening- the 
package. 

If you think that I'm talking about 
serious, professional software here, 
you're absolutely right! Simon & Shuster 
(and Borland International, among 
others) are proving that good software 
sells. And 'good' means, in part, that you 
must have a back-up. This has been taken 
into account and provided for in the 
Agreement. Hats off to Simon & Shuster. 

Having said that, let's have a look at 
the programs. Typing Tutor III and the 
Letter Invaders game are the creations 
of Kriya Systems, Inc. The Kriya people 
have incorporated a very clever idea in- 
to Typing Tutor III. So clever, in fact, 
that they have trademarked its name, 
Time Response Monitoring, and its de- 
rived acronym, TRM. According to the 
manual, TRM "notes the time it takes you 
to type each letter and then uses this in- 
formation to create . . . lessons and prac- 
tice tests that encourage you to respond 
automatically and without error, because 
they are specifically tailored to your own, 
unique requirements". 

This facility sets Typing Tutor III apart 
from other typing programs that you may 
have tried. Since there are many typing 
programs in the public domain, you may 
have one or two of them and you may 
have found (as I did) that they tend to be 



boring and do little to relieve the 
drudgery of typing drills. But Typing 
Tutor III is different. Time Response 
Monitoring affords the user a higher 
degree of interactivity which, in turn, 
leads to a higher degree of user involve- 
ment. Your progress is tracked minute- 
ly, and your results can be displayed on 
a bar graph so that you can examine the 
speed and accuracy of your responses for 
each and every key. Consequently, you 
become more acutely aware of your own 
particular strengths and weaknesses at 
the keyboard. 

The net result of this is great payabili- 
ty, for want of abetter word. Every time 
I run this program I wind up typing for 
hours. And when I stop, it's not because 
of boredom or frustration but simply 
because other tasks require my time and 
attention. Or because I should have been 
in bed an hour ago! Kriya is a Sanskrit 
word whose root meaning is 'do' and this 
program certainly keeps me 'doing'! 

I wanted to find out if others would be 
affected in the same way by the program, 
so I corralled a friend into my chair while 
Typing Tutor III was on the screen. 
She's a competent typist but tries to steer 
clear of computers. Nevertheless, after 
a very few words from me (more of en- 
couragement than of instruction), she 
began to work with the program, follow- 
ing the on-screen instructions. About an 
hour latter, I concluded that Typing 
Tutor III really was as engaging as it 
seemed to me to be and I told her that 
she could stop. "Just let me do a few 
more", she said. 

The programs include on-line help and 
instruction screens that are memory- 
resident and therefore don't require disk 
accesses. Of course, this means that they 
are loaded in every time that you use the 
program. This is a feature that I really 
dislike in a program, but I think that I am 
in the minority in this regard and that 
most users will appreciate having all the 
instructions immediately available. Still, 
I wish that we had a choice about loading 
the help. Typing Tutor III and Letter In- 
vaders are long programs (191 and 134 
blocks respectively). Fortunately both of 
them work with Fast Load. On the 
positive side, the information on the 
screens is clear, concise and complete. 
You may not need that wonderful 
manual. 

From the main menu you have seven 
choices: Alphabet Keys, Number Keys, 
Words Test, Full Keyboard Test, 
Numbers Test, Standard Speed Test and 
Status Report. Alphabet Keys is the place 
to start if you're a neophyte. Number 
Keys is the place to go if you're one of 



those people who still have to look at the 
keyboard when confronted with digits. 
Initiates may elect to go directly to Word 
Test or Numbers Test, and the adepts 
among you may opt for the Full Keyboard 
Test or Standard Speed Test (which 
always shows the same text unfortunate- 
ly). If you select the word or number tests 
after completing a lesson, only the keys 
you've been working on are included. 

The status report is another excellent 
feature of this program. From the status 
report you can change the program 
variables. Specifically, you can turn the 
sound on or off, change the threshold at 
which a key is considered fast, change the 
number of lessons that are presented 
before a Progress Report is displayed, or 
alter the number of lines in a test. This 
is great for adjusting the program to 
adapt to the differing needs of users — 
from the hunt-and-peek crowd to the 
speed demons. 

The program gives very good reports 
on your performance, showing which 
keys have been typed 'fast', which keys 
have been mistyped, your accuracy (ex- 
pressed as a percentage), your actual 
speed and your corrected speed (using the 
standard method of subtracting five 
words per minute for each error). 

The game, Letter Invaders, is more fun 
than Typing Tutor III and offers almost 
as much performance information. The 
idea for the game has been used before 
but this is a first-class implementation. 
Characters fall from the sky endlessly. 
Evidently they are not at all intimidated 
by your land-based lasers, which 
obliterate the attackers when the correct 
characters are typed. Any missed 
characters will decimate the landscape. 
This is a great challenge and a tremen- 
dous responsibility rests on your 
shoulders. If its safety depended on me, 
frankly, the earth would be doomed. I'm 
not terribly fast (50 + wpm) but I have 
very good accuracy. Still, I was no match 
for the invaders; although I did manage 
to pick up a lot of bonus points for triads 
(three successive keystrokes for one 
finger). Where I really got creamed was 
on the special symbols. I use a PC/XT at 
work all day and then come home and flub 
all the keys that are in different locations 
on the 64. Certainly the game taxes your 
skills, and fairly demands that you 
become a better typist. You'll do it too. 
And you'll have fun in the process. 

So for your next keyboard meditation, 
concentrate your mind on Typing Tutor 
III and let Kriya be your guru. It could 
be a (third) eye-opening experience! 

Typing Tutor III with Letter Invaders, 

from, Simon & Shuster. D 
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Starting FORTH 
by Leo Brodie 

Prentice Hall 

Softcover, 360 pages 

Price $20.00 (US) 



Review by R.C. Walker 

Written in the same matter-of-fact style 
as his Thinki7ig Forth, Leo Brodie 's Star- 
ting FORTH is an invaluable reference 
for FORTH programmers at all levels of 
expertise. Since it is also a tutorial , there 
are several exercises, with answers, in- 
cluded for each chapter. If you want 
FORTH, you will also want this book. 
Let's look at each chapter in turn: 

Fundamental FORTH: This chapter ex- 
amines the properties of the language, 
and the design of FORTH words. 
FORTH programming consists of 
developing new words (commands) from 
previously defined words. Although 
FORTH is compiled, it is also interactive. 
Words can be executed simply by typing 
them and hitting the RETURN key. Ap- 
plication source code is normally saved on 
disk in blocks of 1024 characters each 
('screens'), which are compiled into the 
system before executing. Alternatively, 
a completed application can be saved and 
loaded as a precompiled file. FORTH 's 
parameter stack and postfix 
mathematics, the sources of much of the 
language's speed and power, are in- 
troduced here. 

How To Get Results: In this chapter, 
FORTH mathematics is dealt with more 
deeply. Floating point words, though 
sometimes provided as an option , are not 
dealt with, since integer mathematics are 
standard (for reasons of speed), and there 
are methods for overcoming integer 
shortcomings (dealt with in a later 
chapter). Stack manipulation words are 
studied and used. 

The Editor (And Staff): This chapter 
provides a description of a simple editor 
that allows one to create source code. It 
is written in FORTH, and takes the form 
of a separate vocabulary, since many 
words may otherwise be identical to some 
used in FORTH 's main vocabulary. Com- 
ments may be freely added, since they are 
not compiled into the dictionary and, 
therefore, do not slow down execution 
time, as in interpreted BASIC. 

Decisions, Decisions: FORTH, like any 
other language, uses logical operators for 



decision making. These, and FORTH's IF 
ELSE THEN constructs are detailed. 

The Philosophy Of Fixed Point: The use 

of integer mathematics is expanded upon 
in this chapter. In addition to the basic 
mathematics operators, other handy 
words are provided. These include the 
often-used fast operators (to add or sub- 
tract 1 or 2, and to multiply or divide by 
2), miscellaneous operators, and words to 
manipulate the computer's return stack. 
Technical and philosophical aspects of fix- 
ed and floating point mathematics are 
touched upon. FORTH can often over- 
come the problem of not having floating 
point through the use of scaling operators 
and complementary rational approxima- 
tions, as explained in this chapter. 

Throw It For A Loop: FORTH's many 
loop structures are explored. The vari- 
ations in the DO LOOP construct allow 
for some sophisticated applications. 

A Number Of Kinds Of Numbers: This 
chapter explains the various types of 
numbers (bytes, single-length, double- 
length, signed, unsigned, ASCII) used by 
computers, and by FORTH in particular. 
FORTH's normal single-length numbers 
are 16 bits in length (allowing a range of 
over 65,000), while double-length 
numbers use 32 bits (for a range of over 
4 billion). This should allow for more than 
ample precision, using scaling where ap- 
propriate. A useful property of FORTH 
is that practically any number base may 
be used without conversion. Binary, 
decimal, hexadecimal or a non-standard 
base may be used where appropriate. 
Logical operators and a relatively simple 
number formatter are also touched upon 
in this chapter. 

Variables, Constants and Arrays: These 
items are used in FORTH in much the 
same way as in other languages. The use 
of constants, in particular, is encourag- 
ed, since there is no speed penalty, yet 
they aid in documenting the source code. 
Single dimension arrays and their uses 
are examined. Factoring, a programming 
development concept especially suitable 
for FORTH, is introduced here. 

Under The Hood: This chapter examines 
the technical aspects of the FORTH 
language — what makes it run. First up 
is the interpreter, followed by vectored 
execution, a very useful programming 
technique. The dictionary structure 
shown is not that of all FORTH im- 
plementations, although the principles 
will be similar. The author shows how 
new definitions are added to the 
vocabulary. Also, FORTH's use of buf- 
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fers, the scratch pad, variables and 
vocabularies is examined. 

Most FORTH implementations include 
an assembler vocabulary but, since each 
one is patterned after the particular pro- 
cessor for which the system is set up, it 
is not detailed in this book. 

I/O And You: Discussed in this chapter 
is how FORTH handles input and output 
(mostly character strings to and from disk 
block buffers), and other data movement. 
BASIC programmers who have used 
FOR NEXT loops to transfer a block of 
data or fill an array will appreciate the 
speed of FORTH's move commands. 
Manual commands for transferring infor- 
mation between computer and disk drive, 
often handled automatically as a virtual 
memory system, are also presented. 

Extending The Compiler: Defining 
Words And Compiling Words: FORTH 
is a compiled language. The compiler 
modules can easily be added to, as simp- 
ly as defining a short line of source code. 
'Defining words' specify the behaviour of 
words when they are compiled and when 
they are executed (interpreted). For ex- 
ample, variables and constants use dif- 
ferent compile code. This results in dif- 
ferent behaviours when executed. How 
many languages allow the programmer 
such powerful methods of extension? 

A non-traditional flowcharting method 
is also briefly discussed in this chapter, 
in order to more deeply examine two im- 
portant FORTH words, the interpreter 
and the colon compiler. 

Three Examples: Three programming 
examples are presented, primarily to 
teach FORTH style. Good style ensures 
a superior product, no matter what one's 
endeavour. By putting into practice such 
elements as simplicity, structure, ap- 
propriateness and following FORTH con- 
ventions, one will help to ensure that 
their finished product is elegant. 

The first example is a word game that 
prints randomly-chosen phrases. The pro- 
gram is cleverly set up so that the out- 
put seems almost coherent. The second 
example is a simple database implemen- 
tation . The third example demonstrates 
how integer FORTH can handle problems 
that normally must depend upon floating 
point mathematics. 

Whether your pleasure is learning 
FORTH, or just examining some aspect 
of the language, you may be hard press- 
ed to find a better book. It does not mat- 
ter whether you are a novice or an ad- 
vanced programmer, as this book is far 
more than an introduction to FORTH. In 
my library, it is a valued reference. □ 
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Trolls and 
Tribulations 

from Creative Software 

Arcade-style game 
for Commodore 64 



Review by Robert Sodaro 

You are a troll All your life you have 
lived with darkness, dank musti?iess, and 
the overpowering stench you could cleave 
with a dull blade. Danger lurks 
everywhere: carnivorous 'cretins', low- 
Jlying buzzards, troll-crushing 'skulls' 
and poisonous spiders. There are also the 
ever-present rising waters, rank with raw 
sewage from t)ie overworld. . . 

This is the real world of Creative Soft- 
ware's Trolls and Tribulations. Games 
today tend to combine elements of 
previously-established hits into new pat- 
terns, and Creative Software has certain- 
ly done this with Trolls, producing- a uni- 
que and humorous blend of two arcade 
classics: Tutankhamen and Mario Bros. 

From Mario Bros., TtoIIb lifts the 
single-screen, multilevel maze, where 
deadly beasties drop from above to hunt 
you down. In Trolls, the troll (equipped 
with an eight-shot pistol) must first shoot 
the attacking cretin, then knock the 
resulting 'egg' into the murky waters 
below. Coupled with this are a series of 
Tutankhamen-like mazes, where trolls 
must gather up treasures by traversing 
narrow corridors and leaping across 
great chasms. 

Trolls forces the player to plan each 
move with care and precision. A light 
touch and a measure of forethought are 
required, or your hapless troll will wind 
up overplaying his hand and tumbling to 
his doom. 

At the outset of the game, you are re- 
quired to pick the level of play (novice, 
intermediate or expert) by opening the 
appropriate door. Your expedition of 
eight then enters the first set of mazes. 
The entire maze is a actually a multilevel, 
horizontally -scrolling screen, sectioned 
off into levels, each fraught with its own 
particular set of dangers. Cretins (both 
green and red) can be killed, but skulls, 
buzzards and spiders cannot. 

Locked doors appear at each end of all 
maze sections (the maze scrolls off to the 
right), and can only be opened by acquir- 
ing the proper keys. Keys (and treasures) 
are easily obtainable, by either leaping 
from ledge to ledge or dropping to shelves 
below your position. And fear not — long 



falls will not harm you. (Unless, of course, 
you land in the water and drown). 
Strategically-placed trampolines are 
situated to assist in reaching higher 
ledges. Leaping skulls and buzzards in the 
confines of the low tunnels may inhibit 
you, at first, but no harm will befall you, 
since you soon discover that you can't hit 
your head. 

The lower levels are easy enough to 
master but, as you progress deeper in the 
maze, you will need a greater degree of 
skill. Higher levels of play at the deepest 
sections will prove to be a true challenge 
for hardcore gamers. The progression 
from the first sections to the deeper and 
more difficult ones, however, isgradual 
enough to ensure continued interest as 
ability increases. . 

Trolls is a delightful game, but I do 
have two complaints. First, there is no 
way to bypass higher sections and begin 
deeper in the maze — you must always 
start in the first maze of each level, pro- 
gressing through old territory before 
entering new ground. Second, a high 
score is provided, but there is no way to 
save the information to disk (the instruc- 
tions speak of 'memory limitations'). Who 
cares that / can keep track of the high 
score in a single sitting — I want the next 
fellow booting up the game to know how 
good I am! 

Still, Trolls and Tribulations is well 
worth its weight in mystic amulets. 

Creative Software, 230 East Caribbean 
Drive, Sunnyvale, California 94089. O 



Mapping The 
Commodore 64 

by Sheldon Leemon 

COMPUTE! Books, 1984 
268 pages, $14.95 (US) 



Review by Ranjan Bose 

Without denigrating the excellence of the 
Commodore 64 in a large number of 
serious applications, as a reasonably- 
priced yet powerful microcomputer, it is 
also ideal for learning how to program. 
The C-64 has excellent graphics and 
sound capabilities, but if you really want 
to make it run for the money, you have 
to learn about its logical organization, and 
you have to dabble in machine language. 
Over the years, a lot of literature has 
accumulated concerning the various 
aspects of Commodore computers, 
especially the C-64. Mapping The Com- 
modore 64 is very well organized, and is 



one of the most glitch-free reference 
manuals available. It describes all the 
memory locations in the C-64 operating 
system in reasonable detail, and also in- 
cludes subroutines for performing many 
different programming feats. The book 
is a must for understanding what each 
register does, and how the operating 
system utilizes the different memory ad- 
dresses and banks to perform program- 
ming magic. 

One tends to shy away from reading 
about memory maps, because most of 
them make rather dry reading, with fun- 
ny names for addresses and a presenta- 
tion that is unavoidably disjointed and 
terse. Mapping The Commodore 64 is dif- 
ferent. It is very lucid, and actually makes 
rather interesting reading. I just wore out 
my first copy after several months of ex- 
tensive handling, and am rushing to get 
another one before my programming 
comes to a standstill. □ 



Graphics Book For 

The Commodore 64 

by Axel Plenge 

Abacus Software, 1984 

280 pages, $19.95 (US) 



Review by Ranjan Bose 

Sooner or later, you have to grow out of 
conservative BASIC programming, and 
start venturing into the other avenues the 
C-64 makes available. Sound and graphics 
programming are available from BASIC, 
but the slowness of BASIC routines soon 
brings you to the menu of options. These 
are: stay back if you are a chicken; buy 
an extension package, but forget about 
exchanging or selling your programs; or 
learn the nuts and bolts (machine 
language routines, handling VIC/SID 
routines, registers and interrupts); and 
lastly, buy a C-128 or Amiga. 

For the nuts and bolts handyman, this 
book from Abacus is a great help. By the 
time you finish reading it, you will 
understand how to move screens, design 
character sets and sprites, and the 
mechanics of interrupt programming. Us- 
ing the programs provided (sprite editor, 
character set editor, high-res routines, 
and so on), which are also available on an 
optional accompanying disk ($14,95 US), 
and after studying the book several times, 
programming graphics will hold no ter- 
rors for you. From then on, your dedica- 
tion and creative imagination will deter- 
mine how far you go. Highly 
recommended. D 
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Superman — 
The Game 

from First Star Software 

Arcade game for 
one or two players 
for Commodore 64 



Review by Malcolm O'Brien 

I started reading before I went to school, 
and Superman was probably the first 
publication that I read regularly. Over the 
years, wherever Superman went, I 
followed — the comics, the television 
show and the movies. I've been a Super- 
man fan for over thirty years. Since 
Superman is not bound by time or space, 
it seems perfectly natural that he should 
now appear on my monitor screen as well. 

My children, Grace (10) and Sean (9), 
are big Superman fans too. Thanks to the 
miracle of videocassettes, they have seen 
the movies numerous times — occasional- 
ly watching the same film three times in 
a weekend! They both got very excited 
when I told them I would be reviewing 
the game for TPUG Magazine. So we all 
gathered around the C-64 on a Saturday 
afternoon (and evening!) to put the Man 
of Steel through his paces. 

Superman — The Game is the first in 
a new series of programs from First Star 
Software. The series is called the 'Super 
Powers Software Collection', and I ex- 
pect that it will be well received by game 
players at large. This is an arcade-style 
action game, although there are strategic 
aspects as well. 

As with other offerings from First Star 
Software, the program's greatest 
strength is in its graphics. The opening 
screens are superb. When the program 
appears, Superman flies over the 
Metropolis skyline and pauses to wave to 
you. Then an excellent portrait of Supes 
'dissolves' onto the screen, accompanied 
by suitable music. This gives way to a por- 
trait of the evil villain, Darkseid, and the 
music becomes sinister. Real scary, kids! 
The last screen in the opening has the 
famous Superman logo and the program 
credits. The program was written by Jim 
Nangano and Fernando Herrera. 

Mr. Herrera has made quite a name for 
himself as a creator of microcomputer 
graphics. A few years ago, Atari ran a 
contest for user- written programs, which 
was won by Mr. Herrera. His winning 
program, My First Alphabet, was writ- 
ten for his young son. Although it has no 



educational value for anyone older than 
the Sesame Street set, the excellent 
graphics and the overall quality of the 
program were probably what caught the 
eye of the Atari judges. Mr. Herrera's ef- 
forts won him the first (only?) Atari Star 
award, and he then started First Star 
Software. He's been keeping the VIC II 
chip (not to mention the Pokey chip in the 
Atari) busy ever since. 

Superman is no exception. Game action 
is very fast and very complex, graphical- 
ly and strategically. You have to keep 
track of a number of game parameters to 
tip the scales in your favour. Here's the 
setting: 

There are six Metropolis game screens. 
Three of them represent the streets of 
Metropolis, and the other three represent 
Darkseid's network of caves beneath 
Metropolis. When moving between 
screens, the two combatants do battle on 
the ground, under the ground, in the air, 
and in outer space. These transitional 
screens, called 'Combat Zones', can be 
very challenging exercises in themselves 
— the documentation describes them as 
"games within The Game". The Combat 
Zones are, once again, very appealing 
graphically, and a little bit easier to get 
a handle on than the Metropolis screens. 
At the beginning of the game, you can 
elect to play with or without Combat 
Zones. When you're new to The Game 
you may find that including the Combat 
Zones is the only way you can exercise 
a measure of control over the game! 
Although some points are won or lost in 
the Zones, it's the Metropolis screens that 
will make or break you. 

Effectively, the six Metropolis screens 
constitute one large maze, which is 
populated by the citizens of Metropolis 
who will be captured or rescued during 
the course of the game. The citizens 
wander zombie-like through the streets 
and caves. They will blithely walk into 
Darkseid's prison without a second 
thought. The citizens are none too bright, 
and really need Superman's help! Each 
person rescued adds to Superman's score, 
and each one captured adds to 
Darkseid's. Actually, the score has three 
components — points, energy remaining, 
and number of people rescued or cap- 
tured. Two of these, energy and people, 
can decide the contest. Whoever runs out 
of energy first loses. In the beginning, 
this will probably be you! The game can 
also conclude when all the citizens have 
been captured or rescued. In this case, 
the player with the highest people score 
is the winner. With time, as you improve, 
you may win on energy; later on, by con- 
serving energy and playing strategical - 
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ly, you'll start to win games on people. 
Playing the game effectively consists 
chiefly of knowing which of the four main 
game activities to perform at any given 
time. The four main actions are: 
assaulting your opponent directly, 
transporting citizens , rotating deflectors , 
and obtaining dimensionizers (used for 
travelling from screen to screen). 
Assaulting your opponent can be done 
bodily or by means of beams (Superman's 
heat vision or Darkseid's Omega beam). 
The deflectors serve the dual purpose of 
redirecting both the beams and the 
citizens of Metropolis. 

At first I felt that the game was too 
hard. Darkseid seemed to be too smart 
and too fast. Strangely, he seems to be 
able to walk faster than Superman can 
fly! Sometimes, when first entering a new 
screen, Darkseid and Superman appear 
in the same spot. This 'freezes' you, which 
results in a serious energy loss, and you 
are helpless until Darkseid decides to 
move away. To be fair, you can 
sometimes use this same technique 
against your opponent: either to 'buy 
time' when the citizens are moving your 
way, or simply to deplete your opponent's 
energy reserves. While this ploy enhances 
the game strategically, it also diminishes 
the action. Although different players will 
react to this in different ways, there were 
times when I found it downright 
frustrating! 

Aside from this minor complaint, the 
program has one serious flaw that I 
would like to see corrected. At the end 
of the game, when playing against the 
computer, the winner is seen flying 
triumphantly over the Metropolis skyline. 
In the two-player mode, however, the 
game ends abruptly and returns you to 
the 'Selections' board with no indication 
of who has won the game! David Bradley 
and I played the game for several hours 
one evening, and this happened to us 
several times. On one occasion we were 
returned to the 'Selections' board before 
either of had bothered to check our scores 
for the first time! On another occasion the 
Metropolis map showed that there were 
still unaccounted-for citizens; but we 
couldn't find anyone on any of the six 
screens! 

In spite of these problems, which mar 
an otherwise excellent game, I would still 
rate the program highly. It will provide 
users with many hours of fun and 
entertainment. 

Superman — The Game, from First Star 
Software, 18 East 41st Street, New York, 
New York 10017. U 
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Presented by Astrid Kumas 

The following products have been, received 
by TPUG Magazine in recent weeks. 
Please note that these descriptions are 
based on the manufacturers' own 
announcements, and are not the result of 
evaluation by TPUG Magazine. 

Programs for the C-64/128 

COMPUTE! 's Commodore 64/128 Collec- 
tion from COMPUTE! Publications, 
Inc. 324 W. Wendover Avenue, Suite 



200, Greensboro, NC 27408, (919) 
275-9809. Price: $12.95 (US). 

Hard on the heels of the C-128 release, 
COMPUTE! Publications Inc. came up 
with a new title, COMPUTEI's Com- 
modore 64/128 Collection. The book, on 
sale since June 1985, contains ready-to- 
type -in programs for the C-64 and C-128 
in its 64 mode. 

Besides the programs, the book in- 
cludes information on the Commodore 
128. The opening chapter, entitled Inside 
the 128, describes new features of the 



News from Cardco 

At the January 1986 CES in Las 
Vegas, Cardco exhibited its two 
StealthTec utilities, described as the 
first across-the-board transparent pro- 
gram interrupt technology for Com- 
modore computers. 

A transparent interrupt mechanism 
is one which can be called upon during 
the execution of another program . It 
will then 'disappear' when not needed, 
leaving the previous program intact, 
exactly as it was when the transparent 
interrupt was called upon. 

Freeze Frame, the first StealthTec 
program, is a totally transparent 
screen dump utility. With a couple of 
keystrokes, it will immediately send 
whatever is on the screen right to the 
computer's printer. Freeze Frame is 
unique for two reasons: it works on vir- 
tually all programs and all programm- 
ing languages, and it supports any 
printer or printer interface which 
emulates the Commodore 1525, as well 
as any Epson-compatible or any 
Okidata-compatible printer. 

Second program in the StealthTec 
series is a business/productivity utili- 
ty, yet unnamed. It will provide instant 
access to a calculator, an appointment 
calendar, a telephone direc- 
tory/database, a memo writer, a screen 
dump utility, access to all DOS func- 
tions, and more. 

Cardco will produce the initial 
StealthTec programs for the Com- 
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modore 64. Versions for the Com- 
modore 128 will follow soon. For more 
information on StealthTec programs 
contact Cardco, Inc. 300 S. Topeka, 
Wichita, KS 67202. 

Cardco announces also an affordable 
hard disk drive for the Commodore 
64/128 computers. The company claims 
that its Hard Disk Drive is virtually 
transparent to all programs, and offers 
the following features: 

• choice of three memory capacities: 5 
megabytes, 10 megabytes, or 20 
megabytes; 

• high-speed operation (50 to 70 times 
the speed of the Commodore 1541 disk 
drive); 

• expanded Commodore DOS com- 
mands for greater programming 
strength; 

• total transfer of copy-protected 
programs. 

Cardco 's projected retail prices for its 
Hard Disk Drive will be $599.95 (US) 
for the 5-megabyte model, S899.95 
(US) for the 10-megabyte, and 
$1,299.95 (US) for the 20-megabyte 
version. Cardco plans that deliveries of 
the C-64 models will begin late in the 
first quarter, with the C-128 models to 
follow shortly. 

New Amiga Products 

Brown-Wagh Publishing is now shipp- 
ing three new productivity tools in- 
cluding a spreadsheet, telecommunica- 
tions and bulletin board program for 



C-128: CP/M, BASIC 7.0, 128 mode and 
peripheral ports. 

There is also a chapter on programm- 
ing: it offers hints on debugging BASIC 
programs and suggestions for writing 
text-adventure games. 

As for the programs presented in the 
book, they range from games, sound and 
graphics applications to programming 
utilities, and have been grouped accor- 
dingly in three sections: Recreation and 
Education, Sound and Graphics, 
Utilities. 



the Amiga personal computer. 

The spreadsheet program, called 
Analyze!, can be used for financial 
analysis and planning, bookkeeping, 
home budgets, check registers and 
more. Loaded with features similar to 
Lotus 1-2-3, Analyze! can produce 
professional -sized spreadsheets (256 
columns by 8,156 rows). 

OnLine! is a telecommunication pro- 
gram that transforms the Amiga into 
a terminal that is capable of interac- 
ting with micros and mainframes. The 
program can also link up with commer- 
cial information services, as well as 
send telex messages and electronic 
mail worldwide. 

Last program, BBS-PC, is a ver- 
satile electronic bulletin board system 
that transforms any Amiga into an 
online information network. It inter- 
faces to a hard disk or keeps up with 
a 2400bps modem. 

All three programs were written by 
Micro-Systems Software Inc., and are 
being distributed by Softeam 
(1-800-847-6383), National Software 
Distributors (800-821-3612) and Com- 
puter Software Services (800-422-4912) 
in the U.S., and by Phase 4 Distributors 
(403-252-0911) in Canada. 

Analyze! and BBS-PC retail for 
$99.95 (US), while OnLine! retails for 
$69.95 (US). For additional product in- 
formation contact: Brown-Wagh 
Publishing, 100 Verona Court, Los 
Gatos, CA 95030 or call 408-395-3838. 

□ 
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To make program entry easier and 
error-free, the publishers included in the 
Appendices general guidelines on typing 
in program listings, an error-checking 
program called Automatic Proofreader, 
and the machine language entry program 
MLX. However, some readers will cer- 
tainly appreciate the convenience of buy- 
ing from COMPUTE! Publications a disk 
with all the programs found in the book. 
The cost of the disk is $12.95 (US), and 
the toll free number to call and order it, 
is 800-334-0868. 

Assembly Language: 
C-128 Update 

Assembly Langugefor Kids: Commodore 
6Jf with Commodore 128 Update by 
William B. Sanders, published by 
Microcom scribe, 8982 Stimson Ct. ( San 
Diego, CA 92129. Price: $14.95 (US). 

William Sanders' book was reviewed in 

the August/September 85' issue of TPUG 
Magazine, and was highly recommended 
by our reviewer Michael Quigley. Since 
then, Microcomscribe has sent us an up- 
dated version of its publication — 
Assembly Language for Kids: Commodore 
61t with Commodore 128 Update. 



The Update comes as a separate 
29-page booklet, neatly fitting inside the 
main book. It contains the book's pro- 
grams all reconfigured for programming 
in the Commodore 128 Mode using the 
built-in mini -assembler. In addition, a 
C-128 memory map, new BASIC 7.0 
tokens, C-128 Sprite Assembler with the 
new addresses for sprite storage, infor- 
mation on switching memory banks, as 
well as instructions in using the monitor 
and mini-assembler have all been 
included. 

It is also worth mentioning that the Up- 
date lists in the new Errata a number of 
errors which slipped into the original 
printing of the book. 

C-64/128 Portfolio Manager 

Personal Portfolio Manager for the 
Commodore 64 and 128 from Abacus 
Software, Inc., P.O. Box 7211, Grand 
Rapids, MI 49510. Price: $39.95 (US). 

This new product from Abacus Software 
has been designed for investors who need 
a portfolio management and analysis 
system. The program runs on the Com- 
modore 64, SX-64 and Commodore 128 
in its 64 mode. 



Personal Portfolio Manager can be us- 
ed as a tool in three main areas of per- 
sonal investment: 

• Portfolio Management and Analysis — 
to compile various transactions in a port- 
folio and to report its performance; 

• Fundamental Analysis — to select suc- 
cessful investments according to the 
users' particular criteria; 

• Technical Analysis — to study past per- 
formance of a security in order to predict 
its future. 

The program will handle up to one thou- 
sand open transactions on a single 
diskette. 

An interesting feature of the Personal 
Portfolio Manager is that the quotes can 
be entered manually or automatically 
through Dow Jones or Warner Computer 
Systems. For this purpose a Vicmodem, 
Commodore 1650, or a 1660 modem can 
be used. 

The user has also an Autorun feature 
which enables the user to set time for the 
system to log on, update quotes, log off, 
and print reports. 

Personal Portfolio Manager comes 
with a manual divided into the following 
sections: Getting Started, Tutorial, 
Reference and Appendices. □ 




Limited time offer 

$11.00 
$14.00 

(Minimum purchase - 5. Delivery extra. 



Switch 

to the highest 
quality, lowest 
priced brand name 
diskettes available 
in Canada. 

Q. Who has switched? 

A. Professional and educational 

institutions, national accounting 
firms, major engineering firms, 
software houses, computer 
retailers and the Toronto Pet 
Users Group. 

In Bulk - 3 1 /2 inch discs 
SSDD $3.50 each / DSDD $4.00 each 



3C 



Programmers Guild Products Ltd., 255 ManuLife Place, 10180-101 St., 
Edmonton, Alberta T5J 3S4 Phone: (403) 428-6229 



MasterCard 



Calendar of TPUG Events 



Meeting Places 

Amiga Chapter: The new Amiga chapter meetings will be held 
in conjunction with the Westside chapter meetings. 
Brampton Chapter: Brampton Public Library, Four Corners 
Branch, 65 Queen St., on the second Thursday of the month, 
at 7:30 pm. 

Business Chapter: TPUG Office, 101 Duncan Mill Rd., Suite 
G-7, Don Mills, on the second Wednesday of the month, at 7:30 
pm. 

Central Chapter: The Central Chapter will no longer be 

meeting. 

COMAL Chapter: York Public Library, 1745 Eglinton Ave. W. 
Cfust east of Duffer in) on the fourth Thursday of the month, at 
7:30 pm in the Story Hour Room (adjacent to the auditorium). 
Commodore 128 Chapter: TPUG Office, 101 Duncan Mill Rd., 
Suite G-7, Don Mills, on the first Wednesday of the month, at 
7:30 pm. 

Commodore 64 Chapter: York Mills CI, 490 York Mills Rd, (east 

of Bayview) on the last Monday of the month, at 7:30 pm in the 

cafetorium. 

Communications Chapter: TPUG Office, 101 Duncan Mill Rd., 

Suite G-7, Don Mills, on the fourth Wednesday of the month, 

at 7:30 pm. 

Eastside Chapter: Dunbarton High School (go north on Whites 
Rd. from the traffic lights at Highway 2 and Whites Rd. to next 
traffic lights; turn left to parking lots) on the first Monday of 
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the month, at 7:30 pm. 

Hardware Chapter: TPUG Office, 101 Duncan Mill Rd., Suite 

G-7, Don Mills, on the second Tuesday of the month, at 7:30pm. 

New Users Chapter: TPUG Office, 101 Duncan Mill Rd., Suite 
G-7, Don Mills, on the third Monday of the month, at 7 pm. 

SuperPET Chapter: York University, Petrie Science Building 
(check in room 340). Use north door of Petrie to access building. 
On the third Wednesday of the month, at 7:30 pm. 

VIC 20 Chapter: York Public Library, 1745 Eglinton Ave. W. 

(just east of Dufferin), on the first Tuesday of the month, at 7:30 
pm in the auditorium. 

Westside Chapter: Clarkson Secondary School, Bromsgrove 
just east of Winston Churchill Blvd., on the third Thursday of 
the month, at 7:30 pm. 

68000 Chapter: The meetings of the new 68000 chapter will be 
held in conjunction with the meetings of the SuperPET chapter. 

TPUG makes every effort to ensure that meetings take place when 
and where scheduled. However, unforeseen 'problems may occa- 
sionally arise thai lead to a particular meeting being changed 
or cancelled. The TPUG meetings line (U5-90W) is the best source 
of fully up-to-date information on meeting times, and should be 
consulted. 

Are you interested in organizing some other interest group in 
the Greater Toronto area? Please let the club office know, by mail, 
phone or TPUG bulletin board. □ 
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Bulletin Board 



Richvale reborn 

Richvale Telecommunications, was one of the pioneer 
developers of Commodore software .and hardware in the. : 
Toronto area. It bore the very individualistic stamp of its 
owner, Peter Smith, and was locally famous for both its 
creative ferment and its chaotic approach to business — 
which may, after all, have been two sides of the same coin. 
Among their better-known products were a word processor, 
Script 64; a copying utiliiy, Supercopy; and and IEEE in-, 
terface for the 64, the C-Link, 

Richvale went out of business a while ago, after a long, 
unsuccessful struggle to stay afloat, and their passing seem- 
ed like the end of an era (eras being shorter these days than 
they used to be). . 

But a few weeks ago, Smith's wife, Barbara, announced 
the formation of a new firm, Rich-Hill Telecom International, 
to take over where Richvale left off. Rich-Hill will be marketing 
the same hardware and software, line as Richvale, 

Rich-HilS will be kicking things off with an open-house and 
sale on March 14th (evening) and 15th, which we hope is 
some time after you read this. Peler and Barbara invite old 
customers, well-wishers and other interested parties to join 
them for the event in their headquarters at 200 West Beaver 
Creek Road, Richmond Hill, in the Beaver Park industrial, 
park (near highways 7 and 404). For -additional info, call 
731-1621. 

Racter replicated 

Our prayers have been heard, it seems, for Racter has 

added a new persona to its particular form of Artificial In- 
sanity. Racter's legal guardian, Mindscape Inc., has allowed 
the silicon scribe to enter the mind of the Amiga. Our human 
brains boggle at what this prolix program will do with 
multitasking. 

Distressed? Call this number . . , 

David Bradley of the Bradiey Brothers' Bulletin Board 
System has announced a new 'freeware' service. The 
Distressed Commodore Users' Hotline is for those having 
difficulties with their, new machines^ Business hours are 2:00 
pm to 10:00 pm, Monday to Friday at:(418) 488-4776. For 
further information about the service, write to Distressed 
Commodore Users' Hotline, 147 Roe Avenue, Toronto, Ont- 
ario, Canada M5M 2H8. Those with modems can also call 
any of the Bradley Brothers' Bulletin Board Systems at (416) 
487-5833, 481-8661. 481-9047, 277-9991, 24 hours a day, 
7 days a week. 

A mention , . . 

Robert Adler, of the C-64 Users Group of Canada, is mad 
at us because we keep forgetting to mention the existence 
of his club. The club produces an excellent newsletter, Ward- 
copy, and operates both a Help Hotline, at (514) 739-3046, 
10 am to 10 pm daily; and a BBS called Micropolis, at (514) 
739-3446. The address is Snowdon P.O. Box 1205, Mont- 
real, Quebec, H3X 3Y3. Peace is restored. D 




Classifieds 

This space is for the ads of TPUG members. Wanted 
or for sale items only. Cost is 25 cents per word. No 
dealer ads accepted. 

Unclassifieds 

For Sale: 8032, 4040, ADA 1450, Wordpro 4 + , InfoPro, 
all for $500.00 (US) or best offer. Call John (201 ) 263-4538 
(evenings). 

For Sale: SuperPET, 8050 drive, modem, with software — 
OS/9, Stylograph with Spell Check and Mail Merge, C 
Language, 7 Waterloo interpreters, Datamanager. BPI 
General Ledger and Job Costing Module, VtsiCalc, Word- 
Pro 4 Plus. $2,000.00 or best offer. Call Neil Stone, (416) 
440-0368, business hours. 

For Sale: 4032-N CPU $300.00, 4040 Drive $650.00, 4023 
Printer $200.00. $850.00 for whole system. All units with 
documentation. R. Hyam, 225 Cambie Road, Kelowna, 
British Columbia, V1X 3H9, (604) 765-5215. 

For Sale: SuperPET system, including 8250 disk drive, 2023 
printer, WordPro 4 Plus, VisiCalc, other software and 
manuals. $2000.00 complete, or best offer on system of 
component(s). Gordon Ritchie, (416) 626-5442. 
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Ask Someone Who Knows 

If you enjoy Jim Strasma's many books, and his 

articles in this and other magazines, you'll be glad 
he also edits his own highly-acclaimed computer 
magazine, now in its sixth year of continuous 
publication. Written just for owners of Com- 
modore's many computers, each Midnite Software 
Gazette contains hundreds of brief, honest 
reviews. 

Midnite also features timely Commodore 
news, hints and articles, all organized for instant 
reference, and never a wasted word. Whether you 
are just beginning or a long-time hobbyist, each 
issue will help you and your computer to work 
together effectively. 

A six issue annual subscription is $23. To 
subscribe, or request a sample issue, just write: 

MIDNITE SOFTWARE GAZETTE 

P.O. Box 1747 

Champaign, IL 61820 

You'll be glad you did! 



DON'T FEAR THE TAX FORMS! 

If you live in Ontario, TAX-85 is one of the most 
comprehensive, PERSONAL Income Tax 
programs ever written for Commodore systems. 
If you are confused by: T4s, T5s and the many 
other slips, tax rules or tax forms, then TAX-85 
is just for you! 

Tax-85 asks VERY SIMPLE QUESTIONS and 
then makes all the decisions to give your 
MAXIMUM REFUND. It produces completed tax 
forms, on screen or printer, that resemble the 
original. You simply copy the numbers to the pink 
government forms. 

Send $23.75 (includes tax and postage) to: 
-Specify CBM or C64- v 

R.W. Dray & Co 

P.O. BOX 1025 

PETERBOROUGH, ONT. 

K9J 7A5 



Super-OS/9* Is Here 



TPUG has implemented the popular 6809 operating 
system OS-9* on the SuperPET. Super-OS/9 greatly 
expands the software availability and the hardware 
capability of the SuperPET while preserving access 
to the Waterloo languages and programs. 

The cost of Super-OS/9 to club members is $210 
(Cdn) (plus $10 shipment/handling Ontario residents 
add 7% PST), which includes the cost of a hardware 
modification that will not affect the normal operation 
of your SuperPET, installation instructions and the 
operating system disks. 

To obtain your copy please send your cheque or 
money order to: 

TPUG 

101 Duncan Mill Rd., Suite G-7 

Don Mills. Ontario 

Canada M3B 1Z3 

What does Super-OS/9 offer? 

• A true disk operating with features found on UNIX* 
systems and on the AMIGA. 

• Multi-tasking and multi-user capability. 

• Hierarchical directory structure with time/date stamps. 

• Programmable file access privileges for increased 
security. 

Extensive software is available for OS-9, most 
of which runs on Super-OS/9. 



Super-OS/9 Vl.l includes an assembler, editor, 
symbolic debugger, communication software and ter- 
minal emulation package. Available languages include 
BASIC09, CIS COBOL, Fortran 77, Pascal, Lisp, C 
and others. Application software include wordproces- 
sors, spelling checkers, data bases and spread sheet 
programs. 

TPUG has acquired public domain software and 
will assist users in the conversion of commercial soft- 
ware to Commodore format. 

Portability and Expandability 

• Super-OS/9 programs will run on all OS-9 based 
computers (like the CoCo). 

• Super-OS/9 will support standard disk drives (IBM 
format) and the Hi-res graphics board (700 x 300 dots). 

• Super-OS/9 software is C compatible with OS-9 68k 
and AT&T Unix system V. 

For further information call TPUG Inc. at 
(416) 445-4524, ask for Bruce. 

NOTE: If you own a 3 board SuperPET and wish to 
acquire Super-OS/9, please call TPUG before, order- 
ing Super-OS/9, for info about a hardware fix to a 
design error in your SuperPET computer. 

Super-OS/9 is a trade mark of TPUG and Avygdor Moise. 
OS-9 is a trademark of Microvrare and Motorola. 
UNIX is a trade mark of Bell Laboratories. 



Expand 

Past 

Maximum 

Capacity! 




At better book stores everywhere! Or 6 issues delivered to your door 

for just $15.00 {Overseas $21 U.S. Air Mail $40 U.S.) 

The Transactor. 500 Steeles Ave. Milton, Ontario. L9T 3P7. 

416 878-8438 

Also check out The Transactor Disk and The Complete Commodore 

Inner Space Anthology - to us, expansion knows no limits! 



C64 +C128 

^Provincial 
Payroll 

A complete Canadian Payroll 
System for Small Business. 

• 50 employees per disk (1541) 

• Calculate and Print Journals 

• Print Cheques 

• Calculate submissions summary 
for Revenue Canada 

• Accumulates data and prints T4s 

• Also available for 4032, 8032, 

PC-10 Commodore computers 
Fully Supported 
Available from your Commodore dealer 



Oirtrlbuled by: 



ICROCOMPUTER SOLUTIONS 

170 The Donway West, Suite 401 
Don Mills, Ontario M3B 2G3 
Tel: (416) 447-4811 
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10% DISCOUNT 
TO TPUG MEMBERS I 

ON SOFTWARE. BOOKS AND ACCESSORIES 
lEKCtUOING SAIES ITEMSI 
PHONE ORDERS ACCEPIED 
VISA/MASTERCARD.'AMEX 

(416) 633-5605 
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TPUG Magazine 
Distributors 



Dealers: If you, xvould like to carry TPUG Magazine in 
your store, you may order from any one of the following 
distributors: 

CANADA 

Compulit Distributors, Port Coquitlam, BC 604-464-1223 

USA 

Prairie News, Chicago. IL 312-384-5350 

Levity Distributors, North Hollywood, CA 818-506-7958 
Whole Life Distributors, Englewood, CO 303-761-2435 
M-6 Distribution , Houston, TX 713-778-3002 

The Homing Pigeon, Elgin, TX 512-276-7962 

Northeast News Distributors, Kingston, NY 914-382-2000 
Fred Bay News Co., Portland, OR 503-228-0251 

Alonso Book & Periodical, Alexandria, VA 703-765-1211 
Cornucopia Distribution, Seattle, WA 206-323-6247 

Guild News, Atlanta, GA 404-252-4166 

Micro-PACE, Champaign, IL 800-362-9653 

Nelson News 4651 F Street, Omaha, NE 68127 
Summit City News, Ft. Wayne, IN 219/484-0571 

Total Circulation, South Hackensack, NJ 201/342-6334 
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axcnorao 2001 

AN AUTHORIZED COMMODORE SYSTEM DEALER SINCE 1979 

FRIENDLY SERVICE FROM FRIENDLY FACES. 

THIS MONTH ONLY — 15% OFF ALL 

REGULAR PRICED SOFTWARE, ACCESSORIES 

AND MAGAZINES TO TPUG MEMBERS. 



NEW IN STOCK NOW 
1670 MODEM 
1200 BAUD 

FOR YOUR COMMODORE 64 - THIS MONTHS SPECIALS 



SIDEWAYS 
FOR C-64 

$39.95 



THE 
MANAGER 

C-64 
$19.95 



IMAGE 
MAKER 

MPS 802 
HIGH RES. 
PRINTING 

$10.00 



OUBLIETTE 

$14.95 



SPRINT 
PRINT 

FULL SPOOLING 
PRINTER BUFFER 



pkic e e$29.95 




The complete guide 

to the 1541 
operating system. 

$21.95 




$36.95 



PaperClip 

{the word processor) 




$69.95 



with SpellPack 
S89.95 



Boss 

Joystick 




$21.95 



Kraft 
Joystick 




$15.95 



CompuServe 

Starter 

Kit 

$39.95 



PRICES IN EFFECT UNTIL APRIL 30, 1 986 



ELcCROfVO 2001 LTD. 

Name 
Address 


accnorao 2001 ltd. 

5529 Yonge Street, Willowdale, Ontario M2N 5S3 

Tel: (416)229-2700 

Note: All prices in Canadian Funds. Phone and mail orders welcome. 

Ontario residents add 7% sales tax. 

Add 5% lor shipping (minimum charge $2.00) 

■■.. ■■■— jiMav 10% discount for TPUG members on regular 
MB ™» '•*' priced software, accessories and magazines. 


. I Check or money order enclosed D Visa Li MasterCard Amex 
Acct.tf Exp. Date Signature 
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Ahoy! 

Ion International 
S2.50 ••••- 

Monthly publication devoted to Commodore computing. Ahoy! seems to fluctuate from issue to issue, 
but seems recently to be pulling ahead of Run and Computers Gazette in content and style. Of the 
3 'big names,' I would recommend this one most. ( — B.D.) 

Computers Gazette 

Compute Publications 

S2.95 ••• + 

for: C-64 
Slick monthly publication with coverage of Commodore's VIC-20, 64, Plus/4, and newer computers. 
Emphasis is on type-in games and occasional utilities. Reviews are generally candy-coated but rea- 
sonably current. Well-illustrated and laid-out. Goes with the flow, avoiding controversy and originality. 
Features a good selection of advertising. ( — B.D.J 

RUN 

CW Communications 

$2.95 ••• + 

for: C-64, C-128 
This slick monthly Commodore magazine is chock-full of ads, lots of color and photos, occasional 
decent articles. Reviews are often out of date and, worse, not to be trusted. What can you say about 
a supposedly knowledgeable publication that prints shameless gushing praise for a turkey like the 
PLUS/4 month after month. Best features: MAGIC column, and STRASMA's 'Commodore Clinic' (—B.D.) 



In its September-October '85 issue, INFO (formerly INFO 64} Magazine reviewed all the major Commodore-spe- 
cific publications. None received a higher rating than Ahoy! 

Our review is reprinted here. In the interest of fairness, we've also reprinted the reviews of the other two 
members of the 'Big Three— all three reviews word-for-word, exactly as they appeared in INFO Magazine. 

We thank INFO Publisher Benn Dunnington for covering our segment of the marketplace in his usual hard-hit- 
ting style. And we'll try to stop fluctuating! 

'Source: INFO Magazine, September-October '85 



